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INTRODUCTION TO ADVENTURING 



Adventure games are like stories in which the player is 
the hero, and the outcome of the story depends on the play- 
er's wisdom and actions. Adventure games can be grouped into 
two general c lasses--puzzle adventures and fantasy adven- 
tures (or interactive fiction). The game Bomb Squad is a 
puzzle adventure; there is one set of solutions, and your 
success at finding the solution will depend on your logic 
and deductive reasoning. The Visitor is more of a story 
with variable outcomes and more description and character 
development. Your success in a fantasy adventure may depend 
more on your understanding of an opponent's personality than 
on deductive reasoning. 

To play the game, you read information about your posi- 
tion and status on the screen, and sometimes you must study 
pictures presented graphically for clues. The game will ask 
you what you want to do, and you will enter two-word com- 
mands (a verb and a noun) like "kill dragon" or "charm prin- 
cess" or "go south". 



Mappi nq the game . 

It is essential to keep track of the world you are mov- 
ing around it by drawing a map as you go, noting objects in 
various locations, in case you should need them later. Ad- 
venture games consist of various specific locations in which 
action takes place, so start your map with a rectangle rep- 
resenting your present location. Add rectangles ("rooms") as 
you go. 

Develop your own shorthand to keep track of how you got 
from place to place, what objects are in each location, and 
which directions are not passable in each room. 



I nventorv management . 

In most games (including Bomb Squad and The Visitor) 
you can carry only a limited number of things--part ly de- 
pending on your physical condition. You never know what you 
might need for any one situation, so at times you will have 
to drop things in order to pick up others. Keep track of 
where these things are, in case you need them again. 
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using EANTASX gameb 

This manual and tape cover three separate programs. It 
„„irf orobablv be a good idea to play the two games a few 
before you study the material called Adventure Cre- 
ator because once you start analyzing the program in de- 
Jail' most of the solutions to the games will become obvious 
!oi iooil all your fun. Also, if your goal is to write your 
^venture games. you should hive some feel for how the 
player perceives these games without having all the clues 

ah " d Adventure Creator consists of a "framework program", 
which is not a game in its own right. It is designed to let 
vol fill in the details of your own game. The written in- 
structions for Adventure Creator are probably just as impor- 
tant as the program on the tape. since just having the pro- 
gram won't do you much good. without the tutorial material 
that explains it. 



ADVENTURE CREATOR 



Get t inq started 

When you write an adventure game, you will be creating 
a fantasy world in which you make up all the events and 
rules. The world you create can be as fantastic or as real- 
istic as you want to make it. Many adventure games use ma- 
gic, and will be up to you decide how much magic is permit- 
ted. 

First, decide on a theme for your story. You might 
choose a particular time in history, or even prehi story--and 
have your player try to prevent the extinction of the dino- 
saur. Haunted mansions are big favorites, and some adven- 
ture games teach a little history by being factually accu- 
rate in details, while the player tries to do something like 
help Julius Caesar avoid assasinat ion . We're not sure what 
the implications would be if khe player succeeds. 

Once you have a general theme, work out the actual sto- 
ry, which should be built around an ob jec t i ve--de f use the 
bombs, find the alien's mother ship, retrieve the Ring from 
the Lord of Darkness, or whatever. The course of your story 
will always be built around this ultimate objective. 

Then sketch out your world in a rough map. This stage 
will take some imagination and many false starts, as you 
think about your story line in relation to the place where 
it occurs. 



Drawing your " world " 

The first step in making your story into an adventure 
game is to transfer your sketched in "world" to a square 
grid, like the one in the next figure. Of course you can 
make your world any size, but limitations of the computer's 
memory put some limits on you, especially if you want to use 
some memory for graphics and have lots of options in the 
possible actions in the story. 

The grid used in this example is 6x6, so we can have 36 
locations or "rooms" in our game. Make your grid as large 
as possible, because you will want to write in lots of 
notes, treasures and object names. You will refer to this 
diagram many times as you plan story action and keep track 
of which objects are in which locations. 
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Number each location, starting in the top left corner, 
as in the sample grid (which, obviously, is from Bomb 
Squad). We find it clearest to start numbering at I, rather 
than 0 (as some games do). Use a pencil to lightly mark in 
brief room names for each location and the exits possible 
from each room. As your grid drawing develops, you will be 
able to darken in lines for exterior walls and to set off 
such things as cellars and attics. 

As you mark the entrances and exits in each room, use 
the four points of the compass as direction markers. You 
can use little arrows, as in the example grid. If you add 
the interest of going up ladders and down stairs, etc., plan 
routes carefully. Obviously, even going "up" is going to 
require the player to go north, south, west, or east. It is 
a good idea to get used to always naming the directions in 
this order, since we will be using numbers to indicate di- 
rections in the game (north»1 south-2 west*3 east«4). Some 
of your routes may be one-way (the door locks behind you; a 
tunnel collapses after you go through it etc.). 

Make a list of your rooms with all legal exits from the 
room, like this: 
1 . wine cellar S 

2. TV room SE 

3 . pa t i o WE 
etc. for later use. 



Building Jt_h£ story 

Now that your adventure world is mapped out, it's time 
to get serious about our story. You need to plan what the 
player can do in each room, and what objects will be needed 
to do it. In the process of doing this, you will be build- 
ing up a list of verbs to cover the actions needed and a 
list of "gettable" objects (things the player can pick up) 
and "non-get table" objects that will be in the room to stay. 
Keep a separate list of verbs and objects, and list the get- 
table objects ahead of the non-gettable objects in your ob- 
ject list. Eventually, you will want an object list that 
looks like this: 

Object number Object Location 

1. keys 21 

2. amulet 31 

3. scrolls 1 
etc . 

As you place (and perhaps hide) your props around the 
environment, you will be thinking about what the player will 
do with them in each location. If you do hide an object 
(like the crowbar in the grass in Bomb Squad), you will have 
to keep track of what is visible and what isn't. We will 
show you how to do this in our analysis of of the Adventure 
Creator program. It will help a lot if you write in each 
object on your grid diagram. 
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As you plan your game, keep your player in mind. The 
actions, puzzles, and events should make some kind of con- 
sistent sense. Otherwise the game will be impossibly frus- 
trating to play. Of course it's OR to use magic, if your 
world includes magic, but be sure the rules can be figured 
out. Random magic is maddening. Also, try to anticipate 
the verbs and nouns your player might use for various situ- 
at i ons . 
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ANALYZING THE ADVENTURE CREATOR PROGRAM 



Once you have your story planned, you are ready to 
start programming. The purpose of Adventure Creator is to 
give you a "framework program" in which the hard parts of 
the program are already done. Your main job will be to pro- 
vide the details of the "world" of your adventure, and per- 
haps to make up your own graphics scenes. This will still 
be a complicated job, but it should be a fascinating pro- 
cess, in which you will learn a great deal. 

The next section gives you a complete listing of the 
"framework" program, and subsequent sections analyze the 
program in detail. This is probably the best way to learn 
programming. We are assuming that you already know some- 
thing about BASIC programming, so you might have to study 
your computer manual or some other book, if there are de- 
tails of BASIC that you don't understand. 

This "framework" program formed the basis for both Bomb 
Squad and The Visitor, the two games on this tape, and we 
will be using examples from Bomb Squad to illustrate various 
points. You can, of course, list out the relevant parts of 
Bomb Squad and The Visitor if you want more detailed exam- 
ples . 

We will now list the entire Adventure Creator program; 
you will need to refer back to this listing as you read the 
analysis of it. The analysis will make frequent reference 
to the line numbers in the listing, as we explain each step 
of the program. 
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1 : b2 « 1 : b3 = 1 I tl =30: t2 « 60: t3 = 90 



q$: q$ = q$.»." 



pk = pk+1 : NEXT 1 



1 L0!- : Hi : 29650 

50 w = 47: g = 18: rm * 34: bl 
: drS = »|»| tl = 4: tc = 1 

60 00SUB 19900: REM set scene 

65 G0SUB 8500: G0SUB 2160: REM Initialize 

70 H OR : CALL sr: TEXT: REM clear out sprites 

90 GOSUB 500: REM feedback 
100 G0SUB 160: REil input 
110 GCSUB 700: REK condition checks 
120 G0SUP 2000: REM verb action routines 
I 30 uOTO 90 

159 h5H •••••input and analysis of input 

160 PRIKT " What will you do now'"': INPUT 
170 IF qS = " " GOTO 160 
240 pk = 27720 

250 FOR 1 = 1 TO LEN(qS): POKE pk, ASC(MID$(q$, 1, 1 )): 

260 POKE pk, ASC("'") 
290 GOSUB 8630: CALL sr: TEXT 
410 vb = 0: ob = 0: CALL 27430 

450 vb = PEEX(27409): ob = PEEK(27410): w$ = M 

455 1 F ob < vn GOTO 490 

458 ob = ob-vn: RESTORE 

4 60 READ aC: IF a$ <> "load" GOTO 4 60 

470 FOR 1 = I TO ob: READ w$: NEXT 1 

490 RETURN 

499 REM •••••feedback 

500 IF bl > 0 OR b2 > 0 OR b3 > 0 GOTO 510 

^ 505 HOME: PRINT " YOU'VE DONE IT! You must, of course, slip away quietly, but 

507 PRINT " you have the personal satis- faction of a Job well done! It t 
ook you "; t; M moves. ": END 

510 IF bl » 1 OR b2 = 1 OR b3 > 0 GOTO 516 

512 PRINT " Your job is done! You didn't get then all, but the embassy is s 
till there. We may call on you again.": END 

516 HOME: GOSUB 7900 

518 IF tl = 0 THEN PRINT " You're a little nutso.The dog has killed you. M : E 



520 PRINT " Visible exits are *| 

530 FOR 1 = 1 TO LE,l(rS(rm) ): PRINT MID$(r$(rm), 1, 1); " . " ; 

5 35 RESTORE 

537 HEAD aS: IF aS <> "load" GOTO 537 
540 FOR 1 = 1 TO g: READ o3 

550 IF 1(1) = rm AND f(l) = 0 THEN PRINT " You can see "i oS: 
560 NEXT 1: PRINT " "; mS: mS = "What?" 
600 IF ru t 34 THEN GOSUB 2166: GOSUB 6200 
610 IF rm = 13 THEN GOSUB 2160: GOSUB 6100 
620 IF ra ; 8 THEN GOSUB 2160: GOSUB 6500 



NEXT It PRINT 



here. r 
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630 IF rn = 29 THEN G03UB 2160: G03UB 6400 
690 RETURN 

699 ftSM •••••condition checks 
70fi I ? ob = 0 THEN dS = " That's silly." 
730 IP vb - 0 OR vb > vn OR ( ob > 0 AND ob < vn) OR w$ = THEN ■$ = - You 

"rio iF^Vb^'vii AND ob > 0 AND ob <* g AND c(ob) = 0 THEN m$ x "You don't h 
825 t = t-M 

94C IF t > t1 THEN GOSUB 5100 
850 IF t > t2 THEN GOSUB 5200 
S60 IF t > t3 THEN GOSUB 5300 

900 vi = vb: IF vb > 2 AND vb < 1 1 THEN vj « 3 

910 IF vb > 10 AUD vb < 18 THEN vj « 4 

015 IP vb = 18 THEN vj * 5 

920 I? vb > 18 AND vb < 25 THEN vj - 6 

925 IF vb = 25 THEN vj « 7 

930 IF vb = 26 THEN vj =» 8 

935 IF vb > 26 AND vb < 30 THEN vj « 9 

940 IF vb x 30 OR vb » 31 THEN vj • 10 

945 IF vb > 31 AND vb < 37 THEN v j * 1 1 

950 IF vb = 37 THEN vj - 12 

95S IP vb » 38 THEN vj « 13 

960 IF vb > 38 AND vb < 44 THEN vj « 14 

965 IF vb x 44 THEN vj x 15 

970 IF vb > 44 AND vb < 49 THEN vj - 16 

975 IF vb « 49 OR vb » 50 THEN vj « 17 

980 IP vb > 50 AND vb < 58 THEN vj * 18 

9d5 IP vb > 57 AND vb < 66 THEN vj « 19 

990 IP vb * 66 OR vb » 67 THEN vj - 20 

992 IP vb = 68 OR vb * 69 THEN vj « 21 

994 IF vb * 70 OR vb « 71 THEN vj «= 22 

996 IP vb x 72 THEN vj » 23 

997 IF vb x 73 THEN vj - 24 
999 RETURN 

1999 REM •••••verb action routines 

2000 IF vi x 0 THEN RETURN . hln 
2005 IFtc) tl AND v j <> 1 1 AND vj <> 2 THEN »$ « " You oust drop eooiethin 

'2010 OK vj GOTO 2100, 2200, 2300, 2400, 2500, 2600, 2700. 2800, 2900, 30UU, 

°2020°?;: vj-^5 GOTO'3600? 3700, 3800, 3900, 4000, 4100, 4200. 4600. 4700 
2100 HCSTORS: PRINT ■ Words I know:": hp « 0: m$ = 
2110 READ aG: IF aO <> "help" GOTO 2110 
2120 h CAD aG: IF aS « "zz" GOTO 2160 

2130 PR HIT aS; ","; : vc x wc +1 : IP wc > 3 THEN wc = 0: PRII.T 
2140 Hp = hp+1: IP hp x 64 THEN PRINT: hp = 0: GOSUB 2160 
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2150 GOTO 2120 

2160 PRINT: INPUT " Push return to continue."; a$: RETURN 
2200 PRINT H You are carrying:"; : RESTORE 
2210 h EAD aS: IF a$ <> "load" GOTO 2210 

2220 FOR 1 = 1 TO g: READ oG: IF c(l) « 1 THEN PRINT 0$; 



2230 U EXT 1 
2300 d = 0: 
2303 IF ob 
2306 IP ob s 
2309 IF ob = 
2^12 IP ob = 
2344 IF rm = 
let you pass 
?370 f ( 19) = 
?*?2 yon 1 = 

C7.74 

277b IF (uS 
2378 IF ( uS 
21*0 If 1*9 
IF In* 
2334 1. EXT 1 
23*6 



GOTO 2160 



vb-3 



■ S i : 
IF ob = 0 

19 THEN 

20 THEM 

21 THEN 
2 2 THEN 

34 AND ( d = 1 OR d = 4 ) AND f(45) ■ 0 THEN m$ 

": RETURN 

0: rl = LEN(r$(rm)) 
1 TO rl 
US « i:iDC(r5;(ro), 1, 
II" AilD d * 
B" A WD d = 
AND d > 
AND d ■ 



"W" 

" E" 



THEN 
d = 1 
d = 2 
d = 3 
d = 4 



The guard von 1 1 



AND f ( 19) 

AND f(19) 

AND f ( 19) 

AND f(19) 



0) THEN 
0) THEN 
0) THEN 
' THEN 



= 0) 



rm = 
rn = 
rm ■ 
rm = 



rm-6: f ( 1 9) 

rm+6: f ( 1 9) 

rm-1 r f (19) 

rrn+1 : f (19) 



OK." 
= 0 
THEN 



THEN 



23o9 IF f ( 1 9) 

23^0 IF d < 1 

2399 n rTtmn 

2400 IF ob > g THEN tn$ 1 
24 20 IF l(ob) <> rm THEN 
24 50 IF f(ob) <> 0 THEN 
2440 IF c(oh) = 1 THEN 



2452 IF tc > = 
: RETUHN 
2460 IF ob > 



mS = " Can't go that way!" 
H Go where?" 

" You can't get "+w$+".": 
n$ = " It i sn ' t here. " 
m$ = " What "+w$+"? H 
0$ = " You already have it. 



RETURN 



tl THEN tn$ = " You can" 



0 AND l(ob) 



01.'. You have th" " + vG + 
2-170 IF q$ = 
ZAv) RETURN 
2 r »no I F rm = 



rm AND f(ob) = 
tc = tc+1 



t carry more than 
0 THEN cCob) 



"*STR$(tl)+" thinga. 
= 1 : l(ob) = 38: mS = " 



taJte pictures" THEN m$ 



"using what?" 

0 



AND c(2) = 0 AND c(3) ■ 0 AND ob = 47 THEN m$ = 

open it.": RETURN 
The door Is open. You had the tools for the Job. 



30 AND c(1 ) * 
You don't have anything to 
25*0 IF rm = ^0 THEN mS = 
: r$(30) = "NSW" 

2^90 retur;; 

IF ob <= w AND (l(ob) = rm OR c(ob) = 1 ) THEN m$ 
t a M + wG + " . " 

2630 IF rn * 19 AND oh = 36 THEN mS 
2M0 IF rm = 25 AND ob = 39 AND f(2) 
ir in the grass 1 ": f(2) = 0 
2f9° RETURN 



_ It 

■ 0 



Nothing special — jus 



That's disgusting!" 

THEN m$ = " You've discovered a crowb 
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2700 IP ob = 12 AND c(12) « 1 THEN m$ - " It Bays. 'Moveable furniture la dec 

k 2730 lF (ob = II OR ob . 12) AND c(1l) « 0 AND c(12) * 0 THEN mS « ■ How can y 
ou read what you're not holding?" 

2*)0 IF T ob N = 11 AND c(15) « 1 THEN ml » ■ It eaya.'The bookcase movee. The 
mbassador will die'" 

?n?o IP c(15) ■ 0 THEN ml * " You don't have the codebook." • 

2W> IF SI - I AND r» « 15 AND (c(6) - 1 OR c(17) - 1) THEN mS = ■ Good work, 
"'he aobaaeador la safe for now.": bl ■ 0 

2940 IP c(6) = 0 AND c(17) » 0 THEN n$ » " You can't defuae anything with no | 

"^^IP^n^'e AND f(26) » 0 THEN m$ » " A crate'e In the way." 

^DOO I?*rm = 30 AND (c(3) « 1 OR c(2) - 1) TUEN m$ « " The cell la open.": rS| 
xr\\ - "liSW": f(46) = 1 
3010 IP c(3) « 0 AND c(6) - 0 AND r. » 30 THEN o>$ = "You have no keya or crowl 

ar . " 

3099 RETURN . „ 

3100 IP c(ob) = 0 THEN n$ * " You're not carrying It. 

3110 IF c(ob) = 1 THEN c(ob) - 0: l(ob) - rm: ml » " Done.": tc « tc-1 
"51 Q9 R ETURN 

3200 IP ob * 5 AND c(5) * 1 THEN ml » " Ifa lit.": f($) • I 

3210 IP ob = 5 AND c(5) - 0 THEN ml « " You don't have the flashlight." 

3299 RETURN , „_ „ 

3300 IP ob * 5 AND c(5) - 1 THEN ml « " Ifa turned off. 

3310 IP ob = 5 AND c(5) - 0 THEN m$ . " You don't have the flaahllght. 

3400 IP™!^ 15 AND ob » 35 THEN ml - " What good did that do?She'a unconuc 
ous now. " : f (35) ■ 1 

3500 IF T rT* 8 AND ( ob « 1 OR ob » 2) THEN ml « " Oreat.The crate movee. Ther 
•a the bomb!": f(26) » 1 

3510 IP c(ob) « 0 THEN ml - " You don't have It." 

3600 Ip T r£ h = 8 AND ob - 26 AND f(26) - 0 THEN m$ - ■ Ifa extremely heavy. Whu 
will you uae to move it?" .. , . , " 

3605 IP rm * 29 AND ob « 41 AND f(ob) « 1 THEN ml = " It's already moved. 
3610 IP rm * 29 AND ob - 41 AND f(ob) . 0 THEN m$ = " IT MOVES ! Staire lead d 
vn!": f (41 ) * 1 : r$(29) - "WE" 

3700 1p*ob n = 9 AND c(9) « 1 THEN ml = " You doze off for 20 precious minut 
!": t = t + 10 

]2o iP*ob . 44 AMD (bl « 1 AND rm * 15) OR (b2 = 1 AND ro = 8) OR (b3 = I ki 
re = 24) THEN d5 = " Don't do that!": GOTO 6000 
3810 IP rm * 30 AND ob * 46 THEN m$ « " V* ao atrong. What will you uae 
3899 RETURN 
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3900 IF rm = 30 AND f(46) = 1 AND ob = 43 GOTO 3902 

3910 IF rm = 15 AND ob = 35 THEN m$ = " She 1b charmed. As you inspect the roo 
a, you see a bomb" 
399? RETURN 

4000 IF rm = 14 AND ob = 34 AND (c(4) = 0 OR c(l4) = 0) THEN m$ = " You don't 
have anything he wants." 
4010 IF rm = 14 AND ob = 34 AND (c(4) ■ 1 OR c(14) = 1) THEN mS = " Clever. He 
seems to like you.": f(34) = 1 : c(4) = 0: c(14) = 0 

4099 RETURN 

4100 IF f(20) = 1 AND rm = 34 AND f(45) ■ 0 THEN m$ * " Devious but effective. 
The con- promising pictures got him.": f(45) = 1 

4110 IF f(20) = 0 AND rm = 34 AND ob = 45 AND f(45) ■ 0 THEN m$ = ■ What will 

you ur,p?" 
419J nETURN 

4200 IF rm = 11 A JP ob = 18 AND c(18) = 1 THEN m$ = " He's fooled and lets you 

pas:;": f(J0) ■ 1 
4290 R ETURK 

4600 INPUT " Tape or disk r eady?(y/n) " ; a$: IP a$ <> "y" THEN RETURN 
4MO r R I N T CIII?$(4); "open bombgame , d" ; dr$ 
4620 PRItlT CHRS(4); "write bombgame" 

4630 PRINT rm: PRINT bl: PRINT b2: PRINT b3: PRINT til PRINT t2: PRINT t3: PRIN 
T til PRINT tc 
4640 FOR 1 = 1 TO 36 
46 r )0 PRINT r$(l) 
4660 NEXT 1 
4670 FOR 1=1 TO w 
467b PRINT f(l) 
4680 NEXT 1 
4685 FOR L 1 1 TO I 

4689 PRINT 1(1): PRINT c(l) 

4690 NEXT 1 

4695 PRINT CHR$(4); "close bombgane, d" ; dr$ 

46^9 RETURN 

4700 INPUT " Tape or disk ready? (y/n)?"j a$: IF a$ <> "y" THEN RETURN 
4710 TRINT CMRJ:(4); "open bombgame, d"; dr$ 
4720 PRINT CURr(4); "read bombgame" 

4730 INPUT rm: INPUT b1 : INPUT b2: INPUT b3: INPUT t1 : INPUT t2: INPUT t3: INPU 
T tl : INPUT tc 
4740 FOR 1=1 TO 36 
4750 INPUT r$(l) 
4760 NEXT 1 
4770 FOR 1=1 TO w 
4775 INPUT f(l) 
4780 NEXT 1 
47*35 FOB I • 1 TO I 

4789 INPUT 1(1): INPUT c(l) 

4790 NEXT 1 
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4795 PRINT CHR$(4); "close bombgame,d , » j dr$ 

4799 RETURN 

5100 RETURN: REM dummy unusual action routine 
5200 RETURN: REM dummy routine 
5300 R ETUHN : REM dummy routine 

6000 Spio/ol'rf'TO^o! 40 TO 79. 90 TO 0. 158: HPLOT 80, 90 TO 200, 90 TO , 99 

6O10°dPL0T 4 2O0, 40 TO 250, 15: HPLOT 200, 90 TO 250, 150: RETURN * 

6030 tl PLOT x, ; TO x + 30, ; TO x+29. y*20 TO x-1 . y+19 TO x, y: UPLOT x+15. y T 

x + 15. y + 20: H PLOT x, y + 10 TO x + 30, y + 10: RETURN 

6040 HPLOT 130, 90 TO 1 30 , 60 TO 1 46 , 6 1 TO 1 45 . 90: RETURN 

6050 i! PLOT x, y TO x + 25, TO x+24. j*30 TO x-1 , y + 20 TO x, y: UPLOT x, y,, 
r: x + 2^, y+lll HPLOT x + 11 , y-2 TO x + 1 1 , y + 23 

6055 rvSTtIRN 

610C RETURN: REM dummy graphics routine 

6W !!cOLOR = 12: x , 8: y - 22: Q03UB 6030: x * 60: y = 22: G03UB 6030: . . 
75: y * 22: QOSUB 6030 

62?0 nCOLoS J = i 4 : 'upS^TO TO 255. 70: UPLOT 120, 70 TO 1 20, 45 TO 145. 46 

"JtfilSi H 70 W ?58 3 T0 Jto" oMf 180, 158 TO 1 42. 70: UPLOT 48. 158 TO 35, 

! 6230 HCOLOR = 2: HPLOT 0, 80 TO 12, 77 TO 35, 85 TO 34. 1 20 TO 27. 119 TO 28, 

9 fi?50 POKE 4 sa. 95: POKE ee+1 , 160: POKE sa+3. 1*1 POKE ea*l6, 79: POKE sa+17, 1 
0: POKE sa+60. 79: POKE sa+61 , 160 
6255 POKE sal64, 79: POKE sa+65. 160: POKE sa+52, 95: POKE sa*53. 160: POKE ei 

Ik^POKE^M^olfpOKE sa + 45. 10: POKE sa.48. 101: POKE sa+49. 10: POKE .. 

2 6265°P0K2 K s E aO2! 5 64:°?0KE aa*33. 200: POKE sa + 28, 80: POKE sa+2 9 . 50 
6270 CALL sr 

6275 IP f(45) ■ 1 THEN RETURN 
6280 FOR 12 = 1 TO 2 : POR 1 * 95 TO 79 STEP -3 
6263 I* 1 1 « 95 TUEN POR lp - 1 TO 4 : 003UB 7800: NEXT lp 
6286 POKE sa+52, I: POKE sa+56, 1: CALL sr: G03UB 7800 
6290 NEXT 1, 12 

6295 POKE sa+52, 95: POKE sa+56, 95: CALL sr 

6299 RETURN 

6300 RETURN: REM dummy graphics routine 
6400 RETURN: REM dummy graphics 
6500 RETURN: REM dummy graphics 
779J •••••time delay routine 
7300 i Jrt de = 1 TO 100: NEXT de: RETURN 
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A storeroom with big crates 
room 9": RETURN 
room 10": RETURN 
room 11": RETURN 
RETURN 
RETURN 
PRINT 



No wonder you heard an explo- 
RETURN 



sion! This storage 



7899 REM •••••room descriptions 

7900 ON rn GOTO 8010, 8020, 8030, 8040, 8050, 8060, 8070, 8080, 8090, 8100, 811 
0, 8120, 8130, 8140, 8150 

7920 ON rm-15 GOTO 8160, 8170, 8180, 8190, 8200, 8210, 8220, 8230, 8240, 8250, 
8260, 8270, 8280, 8290, 8300 
79?0 ON rm-30 GOTO 8310, 8320, 8330, 8340, 8350, 8360 
8010 PRINT " room 1": RETURN 
9020 PRINT " room 2": RETURN 
9030 PRINT ■ room 3": RETURN 
8040 PRINT M room 4": RETURN 
8050 PRINT " room 5": RETURN 
8060 PRINT " room 6 M : RETURN 
8070 PRINT M room 7": RETURN 
tvmo IF b2 = 2 T : IEN PRINT ■ 
room is a wreck.": RETURN 
kXM FHtSf 

Hoyo print 

8100 PRINT 
81 10 PRINT 
9120 F R I NT " room 12 
91 30 PRINT " room 1 3 
9140 IF f(34) ■ 0 THEN 
oss this yard." 
91 42 IF f (34) = 1 THEN PRINT 
8149 RETURN 

HI 50 IF bi = 2 THEN PRINT 
ite is wrecked.": RETURN 

8151 FT I NT " You have burst in on the 

9152 IF f (35) = 1 GOTO 8158 

8154 IF f(35) ■ 0 AND bi = 1 THEN PRINT 
out !" 

0156 IF f(35) = 0 AND bi = 0 THEN PRINT 
ave returned to her suite" 

She's still unconscious 



That dog will tear you to bits if you try to cr 
The dog peacefully munches his food." 
Smoke and the smell of death. The ambassador's su 



ambassador herself." 



•Get 



•Who are you?' she challenges 
She welcomes you but asks why you h 



81 53 


IF f ( 35 ) = 1 


THEN 


PRINT 


8159 


RETHR! 


i 








91 60 


PRINT 




r 00m 


16": 


RETURN 


8170 


PRINT 


» 


r 00m 


17": 


RETURN 


8180 


PRINT 




room 


18": 


RETURN 


81 90 


PRINT 




room 


1 9 H : 

20": 


RETURN 


8200 


PRINT 




room 


RETURN 


8210 


PRINT 


N 


room 


21": 


RETURN 


8220 


TRINT 


»l 


room 


22": 


RETURN 


82 50 


PRINT 




room 


23": 


RETURN 


8240 


PRINT 




room 


24": 


RETURN 


8250 


PRINT 




room 


25": 


RETURN 


9260 


PRINT 


tl 


room 


26": 


RETURN 


8270 


PRINT 


W 


room 


27": 


RETURN 



B280 PRINT " room 28"? RETURN 
8290 PRINT " room 29" : RETURN 
8300 PRINT " room 30": RETURN 
8310 PRINT " room 31": RETURN 
8320 PRINT " room 32": RETURN 
3330 PRINT " room 33": RETURN 

8340 PRINT " room 34": RETURN . . - nPTimN 

8350 PRINT " You»re at the door of the guard house. : RETURN 

8360 PRINT " room 36": RETURN 
8499 R £11 •••••initialise 

5 slS-DW 2 ^:IS:i^6l!&^:f5:ioo.2oo.72., s . a oo.2oo.76.. J 

8630 sa = 29500: RESTORE 

8640 FOR 1=0 TO 79: READ a: POKE ea+1, a: NEXT 1 
8650 IP ret = 1 TUEN RETURN 
9660 ret * 1 
8750 pk « 27850 

8760 READ a$: IP a$ = "*z" GOTO 8790 

9765 wnun = wnum+1 : IF a$ = "autojack" THEN vx » 1 

8 S 77 6 0 POVJ I ? ;8"«0ShV0«;l. A3C(MID,(a $ . I, .))= pk ■ ^1. NEXT , 
8780 POKE pk, ASC("'"j: pk « pkil : GOTO 8760 

911? Dm 'h.l^ol^ 
k 9?50 < DATA open, eiaalne. look, inspect .eaarch. investigate, explore.read.decode 

9155 DATA defuse, diBBantle, d lsarm, unlock , pry , drop, throw, dump, release, leave 
"too DATA in fight, punch, kick, attack, hit, use, aove .push, shove, pull. consume, drln 
reak, bend, split .shatter, destroy. wreck, burn 

9240 DATA talk. persuade, chara. threaten, convince, flatter. deceive, plead 
^250 DATA feed, distract, bribe. blackmail, show, "flash ", save, load 
9310 DATA autojack, crowbar, keys, meat, flashlight, tools camera, money wne 
9320 DATA rope, letter, "book " .matches, bones, codebook.tirepump.knire, badge. 
l 9^0 tl DATr t t2leviBion t pool, furnace, crate, bed, king, f urnlture. aide, maps, window 
"9370 DATA dog. ambassador. garbage, stairs, weapons, grass, staff .bookcase, car, pr 

3 9515 DATA 237,99,20,107,58,16,107,60,50,16.107,33.52,108 237,91.20,107,26,1 
9520 DATA 254, 94.202.92.107. 254. 93. 200, 35. 19. 195. 77. 107. 19. 237. 83. 20, 10/, 17 

,103 
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9525 DATA 
.107 

9530 DATA 
9535 DATA 

.16.107 
9540 L> ATA 

18,107 
9545 DATA 

07,201 ,256 
9570 pk = 
?530 R f JAD 
9610 D<\TA 
9612 DATA 
°614 DATA 
^6.70 FOR 1 
f ^'0 0 AT A 
C'670 DATA 
3690 DATA 
Q690 DATA 
9700 DATA 
9710 DATA 
9720 FOR 1 
9760 f (2) 
•^01 DATA 
P902 DATA 
qqo4 DATA 
9905 DATA 
9907 DATA 
^909 DATA 

9910 DATA 

9911 DATA 
09 13 DATA 
09M DATA 

9916 DATA 

9917 DATA 
Q919 DATA 
"120 DATA 
9322 DATA 
9923 DATA 
9925 DATA 
0926 DATA 

9928 DATA 

9929 DATA 
99?1 DATA 
P932 DATA 
9°34 DATA 
99 35 DATA 



14,0,33,52,108.6,0,235,167, 2 37,66,235.14,0,26,71 ,126,254,94,202,150 

50,22,107,120,254.94.202,63,107.58,22,107,184,202,145,107,33,52,108 
19,195.105.107,35,19,12,195,114,107.58,17,107,230,255.194.180.107.58 

50.17.107.33.72.108,235,167, 237,82,235.123,50,15,107.195.63,107,58, 

230,255.194,195,107.58.16,107.50,18,107.195.63.107.58,16,107.50,19.1 

274 30 

a: IF a < 256 THEN POKE pk, ai pk = pk+1 : GOTO 9580 
3^.25,18,20, 7.12.00,12, 1, 5,29,29, 4,19. 5.33,20,17 
0,0,0,0,2,4,7,8,10,10,10,1 1 ,12,18,0,14,15,19,22 

24, 25, 26,29,33. 36, 24. 34, 30,0 
=1 TO w: READ 1(1): NEXT 1 
°. ^.V/P.r/S.Sfc'E.W 

n?;,HS"./ t !?E,N3W,'ir,E,llV 
WS.KSE .sv.vjsF.irw.s 

US, l,ME,l!3WE,W,?IV 
RB,V5,W5,NVE,V,N 
= 1 TO 36: READ r$(l): NEXT 1 
» 1 : f (43) * 1 : c(7) = 1 
255.255.255.255.255.255.255.255.255.255.255.255.255.255.255,255 
255,255.255.255.255.255.255.255.255,255,255.255,255,255,255.255 
255.255.255.255.255,255.255.255,255.255,255,255,255.255.255,255 
255.255.255.255,255.255,255,255,255,255.255.255,255.255,255.255 
255,255,255,255,255.255,255,255,255,255.255,255,255,255,255,255 
255.255,255,255.255.255.255,255.255,255,255.255,255.255.255.255 
255,255,192.192.192,192.192,192,192,192,192,192,192,192,255,255 
255.255.3,3.3,3,3,3,3,3.3,3,3,3,255,255 

255,255,128,128,128,128,128,128.128,128,128,128,128,128,128,255 
255.255.1 .1 .1 ,1 .1 ,1 ,1,1,1 ,1 ,1 ,1 ,1 ,255 

255.191 .223.224.239,239,239.224.223,128.239,239.239.224.223,128 
255 ,253,251 ,7,247,247,247,7,251 ,1 ,247,247,247,7,251 ,1 
3,7.13.55,63,127,251 ,239,255,247,253,127,59.15.15,3 
224,240,252,252,126,237,255,247,255,191 ,251 ,254.252.252,240,224 
9,45.180,82,86,1 12.41 ,237 , 228 , 1 79 .21 1 ,87 , 1 23 , 63 ,55 ,23 
90,220,153,166,166,77,125.1 36.190,246,83.215.204,200,246,214 
25,15,7.3.2.3.3.3,3,3,3,3,3,3,15,124 

1 36,152,240,224 ,96,224,224,224,32,224,224,224,224,224,249,158 

255,240,240,224,224,224,240,224,192,192,192,192,192,128, 123,128 

255,15,^1 ,127.127,15,3,3,3,3,3,3,3.3,3,3 

0,0,0,0,0.1 ,2,13,59,54,61 ,63,63,63,62,60 

0 ,0 ,0 . 0 ,0 . 1 29 , 1 28 , 1 29 , 1 28 , 1 28 , 1 28 , 1 28 , 3 1 , 50 , 1 24 

0,0,0,7,3.16,16,63,63.76,204,248,255,0,0,0 

0,0,0,240,8,6,6,252,252,50,51 ,31 ,255,0,0,0 



IC 



9937 DATA 0,0,0,0,0,0,0,0,0,50,48,3.0,48,48,48 
9936 DATA 4 4:4.4,4.32.80,0,0.76,140,224.0,12,12,12 
Q940 DATA 0,3.7.6,12,12,12,108,108,60,28,12,0,0,0,0 
9^41 DATA 0,252,252,14.6,6,6,6,6,7,7,6,0,0,0,0 
9^43 LATA 0,0,0,1,3.3.3,3,1.0,0,0,15.15.25,49 

9Q44 LATA 0,0,0,240,88,246,248,16,224.192,224.224,252,252,246,243 

9946 DATA 0,3,4.4.1 .0,0,1 ,0,0,0,31 .63.51 .99.195 

9947 DATA 0,240,8,4.0,0,0,224,0,0,0,28,254,242,243.243 
9949 DATA 0,0,3,3.6,7.7,4.1.0,1,0,0,0,0,0 

9^0 DATA 0 0,240,248,216,248,248,16,224,192,224.224.0,0,0,0 
9'52 l> ATA 0.0.0,0,0,8,8,24,104,254.31.31.63,100,68,194 
oi>55 DATA 0,0,0,0,0,0,1 ,1 ,1 ,62,254 ,255.254 ,14,9,17 

D A°A 0,0,0,0,0,8,8,24,249,62,11 1 ,143,15,14,20,18 
L- ?C l^k 0,0.0,0,0,0,1,1,1.62,254.254,255,31,18.20 
>>5S 0 0 15.24 46,96,255,248,232,230.194.198.232.224.248.255 

DA? A 0:0.255.3:7. 13. 249. 249. 57. 57. 25. 25. 57.58. 252, 248, 256 
Jd = 2b850: 1 = 0 

a: IP a = 256 GOTO 10030 

sdfl, a: 1 = 1 + 1: GOTO 9997 .„ M _ m 

14,226.6,1,205,32,253.58,24,252,253.33,80.00,33.178,112,17.00.00.2. 



DATA 
,d = 
99 »7 H2AD 
ooc,5 POKE 

1)010 DATA 
,44,253 
10020 DATA 
13030 Br « 
10040 READ 
10~>50 POKE sr+1, 
10200 HETUIli; 

t^-jOO U0K2I PRINT T AB( 6) ; "OPENING DESCRIPTION" 

19^10 PRINT: PRIWT " description.": PR1IIT ■ Pleaae wait 



58,23,252,253.33.20,00,17.00,00,33,60,115.205.44,253.201 ,256 
29600: 1 = 0 

a: IP a = 256 GOTO 10200 

1 = If 1 : GOTO 10040 



a moment. 



RETUKII 



1 
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General structure of the program 

Memory map 

In the ADAM, BASIC uses up memory up to memory location 
27407. in Adventure Creator, we have to reserve a part of 
memory for two important functions that are handled in ma- 
chine language, rather than BASIC, because machine language 
is so much faster. The area from 27407 is reserved by the 
command LOMEM:29650. Thus, the area from 27407 to 29650 
will not be used by BASIC. 

Each of these program parts will be explained in detail 
later. In this section, we will just locate them for you. 

The PARSER analyzes the player's input to see which - 
verb and noun were used. It takes memory from 27407 to 
27849. (Actually, a little memory is left over unused to 
make it easier to expand the program later if desired). 
From 27850 to 28849, the vocabulary understood by the pro- 
gram is placed. 28850 to 29490 hold the sprite data that 
define the shapes of the 20 sprites used in the program. 
29500 to 29580 hold 80 bytes that define the attributes of 
the 20 sprites--4 bytes per sprite. From 29600 to 29640 is 
the machine language routine that controls the sprites. 



BASIC program map . 

This listing uses program line numbers. 
1-150 overall supervisor section 
160-499 get input and analyze input (parser) 
500-999 description and feedback 
2000-4799 verb action routines 

5000-5399 unusual actions routines (explosions in Bomb 
Squad ) 

6000-7000 graphics 

7900-8400 location descriptions 

8500-10010 initialization routines. 

19900-end set opening scene 

Note that the general strategy is to place often used 
parts of the program near the beginning. This is because, 
when BASIC is looking for a subroutine or a place to GOTO, 
it starts at the beginning of the program. The extensive 
initialization and the opening description are only used 
once, so they're at the end. This greatly speeds up the 
program and makes it more fun to play. 
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jnifr ^ization 

There are many things to be done before the game is 
readv to play. In Adventure Creator. this takes about 13 
seconds. First the opening description comes up on the 
screen, so the player has something to read while waiting 
for the initialization to finish. This is accomplished by 

Line 50 initializes a number of variables necessary for 
the oame. v-47 sets the number of objects or nouns. g«lB 
sets the number of "gettable objects". rm-34 sets the room 
number for the player's location at the start of the game. 
bl-1 b2-1 b3-1 are unique to Bomb Squad, but they illustrate 
a programming method. If bl, for example, equals 1, we know 
that the first bomb is still ticking away somewhere; if it 
has been set to zero by the program, the bomb has been de- 
fused; if it has been set to 3, the bomb has exploded, tl-30 
t 2-60 t3-90 set time limits in Bomb Squad. The program 
keeps track of "time" by counting the number of moves made. 
Thus it is easy to check if tl (time |U has been exceeded 
and take the appropriate action. 

Still on line 50, dr$-1 determines which storage device 
is used for saving games. As long as dr$»1, the program 
will SAVE to and LOAD from the tape drive. If dr f" 5 » thc 
disk drive will be used. tl-4 sets the player s total 
load"--the number of objects that can be carried. tc-i is 
the number of objects actually being carried at the moment. 
It is set to 1 here, because the player starts out with the 
camera in Bomb Squad. You might want to change it to zero, 
depending on how your game starts. 

Line 8500 reserves room for 4 arrays. If you don t un- 
derstand arrays, you should study a book about BASIC, but in 
general, an array is a block of memory that operates like 
numbered boxes. The DIM command, dimensions or reserves the 
arrays you want. 

Array c(w) will keep track of what the player is carry- 
ing. The variable w is the number of nouns or objects in the 
vocabulary; w was set to 47 in this game, back in line 50. 
When a program is RUN, all variables are set to zero, so 
there is no need to set any of the numbers in c(w), unless 
the player is carrying something to start with. In Bomb 
Squad, the player starts out carrying a camera, so in line 
9760, you will find that c(7) is set to 1. This is because 
the camera is item #7 in the vocabulary of nouns (see lines 
9310 to 938u). Notice that only the first 18 objects are 
things that the player £an carry — these are "gettable" ob- 
jects, so only c(1) through c(l8) will ever actually be used 
for items being carried, but we still reserve space in the 
c(w) array to check in case the player says something like 
"throw car*. 

The array l(w) keeps track of the location of each ob- 
ject. In lines 9610-9620 we will set each value in array 
l(w) depending on which room each object is in. For exam- 
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pie, if the first object in our object list is "autojack" 
and it starts out in the garage, which is room 33, then 1(1) 
will be set to 33. During play, if the player picks up an 
object, the location of that object will be set to zero. 
Later the player may put the object down, so we will keep 
track of where the object is by changing its value in the 
l(w) array. 

The array f(w) keeps track of "flags" for each object. 
These flags make the game much more interesting. A value of 
zero indicates that the object is in its normal state. For 
example, in Bomb Squad, the ambassador is object number 35. 
The game starts with f(35)-0. If the ambassoador gets 
knocked out, f ( 3 5 ) is set to 1, indicating a changed status. 
As another example, the crowbar is object number 2. At the 
beginning of the game, it is hidden in the grass. f(2)-1 
until it becomes visible; then f(2) is changed to zero, be- 
cause that would be a "normal" state. 

Array r$(36) stores the visible exits for each room. 
In 1 ines 9660-9720, each location in the array is filled. 
For example, the visible exits for room 34 (the starting lo- 
cation in Bomb Squad) are north, west and east. Thus, the 
34th value (in this case, the 4th piece of data in line 
9710) is NWE. 

Lines 8600-8660 POKE into memory, starting at memory 
location 29500, the 80 attributes of the sprites. These are 
the first of many pieces of data to be POREd into memory. 
The sprite attributes are first because we are going to be 
poking them into memory many times in the program—in fact, 
each time we set up a new graphics scene. Look at line 
8650. The first time through, the variable "ret" will be 
zero (all variables are set to zero when a program is RUN), 
so this line will be ignored. However, the next line sets 
"ret" to 1. Thus, we can now use lines 8630-8650 as a sub- 
routine that POKEs in the original sprite attribute data. 
When we analyze the graphics routines, you will see the com- 
mand GOSUB 8630. This sets up 20 sprites in a location that 
is not visible on the screen. Then with the screen clear of 
sprites, we can move the ones we want onto the screen by 
changing some of the attributes. (As you will soon see, the 
first two numbers of each set of four places the sprite ini- 
tially at coordinates x-200 and Y-200, which is off the 
screen . ) 

Lines 8750-8790 PORE the next data into memory. This 
data is the vocabulary of the game. The words will be POKEd 
in starting at memory location 27850. Each word in the data 
is read and then POKEd into memory, one letter at a time by 
line 8770. At the end of each word, the character " A " is 
POREd in because the parsing routine needs some way to rec- 
ognize the end of a word or phrase. (As you will see later, 
the vocabulary could contain phrases rather than just words, 
if you want to get fancy.) At the end of the vocabulary 
data section, the last "word" is "zz". When line 8760 en- 
counters "zz", it jumps to line 8790 and POREs in "j" to 
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mark the end of the vocabulary. Note that the first words 
are the verbs and the objects (nouns) come second. If you 
add or subtract verbs, be sure that "save" and "load" are 
always your last verbs. Line 8765 keeps track of the total 
number of words by incrementing variable wnum. Line 8766 
keeps track of the number of verbs. It stops counting after 
the word "autojack" is encountered — which happens to be the 
first noun in this list. 

The data in lines 9510-9560 are the values for the ma- 
chine language parsing routine (see the parser section for 
details). Lines 9570-9580 POKE these values in, starting at 
memory location 27430. 

Line 9620 reads in the locations of each object into 
array l(w), as discussed before. The data in lines 
9610-9614 show which rooms hold each object. For example, 
object H is in room 133. Object I 2 is in room I 25 etc. In 
this list, object |7 has a location of zero, because the 
player is carrying it at the start of the game. Object • 33 
is zero because, in this example, it is a fence that is in 
many locations. Objects 19,20,21, and 22 are also zero be- 
cause they are not really objects at all. Look at the vo- 
cabulary list, and you will see that they are the directions 
north, south, west and east. We need to include them as 
nouns because the player can indicate a direction to go with 
the sentence "go south", for example. 

Line 9720 fills the r$(36) array, as discussed previ- 
ously. 

Lines 9901-9959 contain the 640 values needed to define 
the shapes of the 20 sprites used. The section on sprites 
will explain all this. Lines 9997-9998 POKE these values 
in, starting at memory location 28850. 

Lines 10010-10020 are the values for the machine lan- 
guage routine that controls the sprites. Lines 10030-10050 
POKE this routine In, starting at memory location 29600. The 
variable sr (for sprite routine) is set at 29600, so we can 
CALL ar later when we do graphics. 

Lines 19900-19955 set the first scene for the player. 



BtifiXiatjflfl and UtdbtfiA 

The lines from 500-699 and the "room descriptions" in 
lines 7900-8360 write to the screen after each move to tell 
the player where he or she is and what happened as a result 
of the last action. 

Lines 500-512 check each time to see if the game has 
been completed. In Bomb Squad, it checks the status of each 
bomb. If they all have been defused, congratulations are 
offered. If bomb 3 ia defused but at least one of the oth- 
ers has exploded, and the other one is defused or exploded, 
lukewarm congratulations are offered. You will see else- 
where in the game that if bomb 3 explodes, the game ends in 
total disaster. 
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Line 516 clears the screen and prints the description 
of the player's location. Let's skip to the room descrip- 
tion routine starting at line 7900. 

The variable rm always represents the number of the 
room the player is in at the time. Lines 7900,7920, and 
7930 will cause a jump to the lines that describe the cur- 
rent room. Notice how the lines are numbered to help you 
keep track of your room and find the right lines quickly for 
debugging. 8010 is for room |1 f 8220 is for room #22 etc. 
You always know the middle two numbers of the line number 
correspond to the room being described. Of course, we don't 
know what each of your rooms will be like, so in most cases 
we have just put " room 1" etc. where you will put the actu- 
al descriptions of your rooms. Notice that in the descrip- 
tions, the first character in the string is a space. This 
is necessary because on some TV sets, the first character is 
displayed off the left side of the screen. 

We have, however, included some descriptions from Bomb 
Squad to illustrate some techiniques. For example, lines 
8080-8084 describe room #8. Bomb #2 (whose status is kept 
track of by variable b2) is in room 8. If it has already 
exploded (b2-2) we will want a much different description 
than if it has not (b2-1 or -0). 

In room #14 (lines 8140-8149) we see the use of 
"flags". If the dog is in his normal state — that is, hungry 
and mean--his flag, f(34), still equals zero. However, when 
he is fed, the program sets his flag to 1, and we get a much 
different room description. 

In the ambassador's suite (room #15) we get even more 
complicated. Several different things might be said, de- 
pending on the status of the bomb in her suite (what does b1 
equal?) and on whether the player has knocked her out, 
changing the status of her flag, f(35). 

One last point, in line 8350, the spacing looks odd on 
paper. However, when you list this line on the screen, you 
will see that the extra spaces are there to prevent the word 
"guard" from being split at the end of the line. 

Now let's return to the feedback section at line 518. 
This is a condition check that only works placed here in the 
program. The only way variable tl (total load) can be re- 
duced to zero is if the player repeatedly tries to get past 
the dog without using strategy. Obviously, this line is 
unique to Bomb Squad, but you might have similar conditions 
arise in your games. 

Lines 520-530 are absolutely essential. They take the 
letters in r$( ) for this room and list them one by one to 
show the player what exits are visible from the room the 
player is in. If an exit becomes visible during the game, 
we will change the letters for that room in r$( ). We will 
discuss this in more detail later, but for example, if the 
player's flashlight reveals a hidden door in room # 12 on 
the south wall, when that happens r$(12) will be changed. 
If previously there were three visible exits, r$(12) would 
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have been " NWE H . Now we just include the statement 
r $ ( 1 2 ) - "NSWE M , and the next time the player is in room 112, 
all four directions will be listed as visible. Similarly, 
if a door locks behind the player, we might subtract a legal 
exit. 

Lines 535-560 add to the room description by listing 
all the "gettable" objects in the room. Line 535 RESTORES to 
the beginning of the data statements. Line 537 simply reads 
from the data statements to skip over the ones we're not in- 
terested in here. When it reads the word "load" it knows it 
is at the end of the verbs. (This is why the verb "load" 
must always be your last verb.) Line 540 loops through all 
the gettable objects, reading each noun, one at a time. 
Line 550 checks if the location of each object is in the 
current room and if the object is vi si ble--that is, its 
flag-0. If both conditions are met, the name of the object 
is printed out. 

Finally, line 560 ends the loop and prints out m§ , 
which is the feedback (message string) that much of the rest 
of the program is devoted to. m$ is changed many times in 
the program and should end up with a meaningful message for 
the player--such as H You can't go that way." or "Excellent 
move! The amulet weakened the monster" etc. As soon as the 
feedback is given, m$ is set to "What?". This is the "de- 
fault" feedback. If nothing else happens anywhere else in 
the program (very unlikely), the player will get this feed- 
back, and will have to try some other command. Notice that 
an extra space is printed just before m$ is printed. This 
is also because some TVs don't show the first column of each 
line with the ADAM. 

Lines 600-630 present the graphic illustrations for the 
four rooms that have graphics. In each line, GOSUB 2160 
causes the program to print "Push enter to continue" and 
then wait for the player to push enter. This permits the 
verbal descriptions and feedback to stay on the screen until 
the player is ready to see the picture. Notice that 2160 is 
really part of one of the verb action routines, but it 
serves nicely whenever we want this kind of pause inserted. 
Then the final GOSUB in each line calls the graphics rou- 
tines. 



iQfiiU 

After the player is given feedback and a description of 
where he or she ia, the question "What will you do now?" ap- 
pears on the screen. Line 160 gets the player's input as 
q$. The player is not permitted to use commas in the input, 
since the INPUT statement ignores everything after the com- 
ma. This is no problem in most adventure games, since only 
two word commands are permitted. If you want to permit com- 
mas, use the input routine given later in the section on 
"the parser". 
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For the parser to analyze this input, the input must be 
POKEd into memory starting at location 27720 and be termi- 
nated with the character " A ". Lines 240-260 take care of 
this. Line 280 clears the screen in preparation for the 
next feedback. 

As soon as the input phrase is in memory, lines 410-499 
set the verb number (vb) and object number (ob) to zero and 
CALL the parser routine. 



The parser 

A "parser" separates a sentence into words and permits 
the analysis of those words. In most adventure games writ- 
ten in BASIC, the parser uses string manipulation and is so 
slow that the game is limited to a vocabulary of about 20 
words. Adventure Creator uses a machine language parser 
that permits a large vocabulary (Bomb Squad has 73 verbs and 
43 objects, for example) and is very fast. In fact, this 
parser has features that are not used in Bomb Squad. We 
will describe its features, since you might want to use them 
in your own games or for other programs. 



How i t operates . 

Remember that the input routine POKEs the player's in- 
put into memory at 27720. The initialization routine POKEd 
the whole vocabulary into memory at location 27850. When 
you CALL 27430, the parser routine takes each word in the 
vocabulary and tries to match it to the input sentence. 
When it finds the first match, it puts the number of that 
word into memory location 27409. That is, if the player's 
input was "persuade ambassador", the parser routine will try 
to match each of the vocabulary words to the input sentence, 
and when it reaches the word "persuade" in the vocabulary 
(this is word #59 in the vocabulary) it will find a match 
and will put the number 59 in location 27720. Then it will 
try to match the second word in the input sentence and put 
its number in location 27410. If no match is found, those 
locations will be zero. In our example, "ambassador" is 
word #108. 

Thus, line 450 can set the value for the verb (vb) and 
object (ob). (Note that line 458 subtracts the number of 
verbs from ob, so we know which object this is, rather than 
which word from the entire list.) 

There is a problem you will have to watch out for. Look 
at line 9195. The word " light" is in quotation marks and 
has a leading space. Otherwise, the parser would be con- 
fused by a word like "flashlight" because it would find a 
match btween the word light in its vocabulary and the input 
word flashlight. For the same reason, the directions N, S, 
W, and E must be in capital letters, or the parser would 
match them with any word containing the letter. 
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Extra fcpmca 2i ill* pgrasr • 

Although most adventure games use two word commands as 
in Bomb Squad, the parser routine can include phrases in its 
vocabulary as well. In the data statements containing the 
vocabulary, you night include the phrase "why me?" as one 
entry in your vocabulary data. The parser will look (or 
this phrase in the player's input. 



fflpcjer jpput. 

If you do use the parser (or some application that per- 
mits the use of phrases, the player will often enter sen- 
tences that include commas. This possibility requires you 
to use a more complicated input routine than included in Ad- 
venture Creator, which simply uses an INPUT statement. *The 
INPUT command ignores anything typed in after a comma. 
Change line 160 and add the following lines to the input 
routine in Adventure Creator 

160 print " What will you do now?" 

180 q$- 

185 get p$:print p$jx i( p$-"," then p$-" ■ 
190 if asc(p$)-13 goto 240 

195 if asc(p$)-8 and len(q$)-1 then q$-"":goto 185 

200 if asc(p$)-8 then q$- le f t $ <q$ , len (q$ ) - 1 ) : goto 185 

210 q$-q$+p$sgoto 185 

220 if q$-"" goto 185 

These lines convert commas to spaces, look (or the car- 
riage return (asc(13)) and handle backspaces (asc(8)) cor- 
rectly. 



l£o more c*Ufl BaXlAI features. 

The parser can actually find as many as three words or 
phrases. With most adventure games, only two words, a verb 
and a noun, are permitted, but if you ever have a use for 
it, our parser will look (or a third phrase. If it finds a 
third match to the vocabulary list, it will put the number 
of that word or phrase in memory location 27411. 

Finally, the parser also keeps track of where in the 
player's input phrase the first match was (ound. In other 
words, if the player input "don't go home", and the (irst 
matching word (ound was "go", the location of "go" in the 
sentence will be indicated as 8. That is, the end of the 
matched word or phrase is at the eighth character. The par- 
ser will place this number in memory location 27407. You 
will have to use your imagination to find uses (or this fea- 
ture, but if you are trying to analyze a sentence input by a 
player, this information is often useful. 



AaacmfrlY UMMM1 Hating oj. £il£ Parser . 

Most users will probably not be familiar with assembly 
language, but (or those who are, here is a commented listing 
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of the parser routine. The first number in each line is the 
decimal address of the code listed in that line. The second 
number is the same address in hexadecimal. The actual pro- 
gram values (in hexadecimal) are next, follwed by the assem- 
bly language code. 



27407:6 BOP 


0 






27408:6B10 


a 






27409:6B11 


0 






27410:6B12 


0 






2-74 1 1 :6B13 


0 






274 1 2 : 6 B1 4 


0 






274 1 3 : 6B15 


0 






27 4 1 4 : 6B1 6 


0 






2/430:6B26 








27 4 30 : 6 B26 


AP 






27 4 31 :6 B27 


OE 


dl 




27433:6B29 


32 


1 1 


6B 


274 36 :6B2C 


32 


12 


6B 


274 39:6B2P 


32 


13 


6B 


274 42:6B32 


32 


OP 


6B 


27445 :6B35 


32 


10 


6B 


274 4a:6B38 


21 


CA 


6C 


27451 :6B3B 


ED 


63 


14 6B 


274 55:6B3P 


3A 


10 


6B 


27458 :6B42 


3C 






274 5 9 : 6 B43 


32 


10 


6B 


27 4 6 2 : 6 B46 


21 


34 


6C 


27465:6B49 


ED 


5B 


14 6B 


27469:6B4D 


1 A 






27470:6B4E 


77 






274 71 :6 B4P 


Pfi 5E 




27473:6B51 


CA 


5C 


6B 


27476:6B54 


PE 


5D 




27478:6B56 


C8 






27479:6B57 


23 






27480:6BS8 


13 






274 81 :6 B59 


C3 


4D 


6B 



PHI END DEPB 0; end of phrase 1 
CUHPHR DEPB 0 

PHCNT1 DEPB 0; | of lat phrase 
PIICNT2 DEPB 0 
PHCMT3 DEPB 0 

V0CADD DEPB 0;current address in vocabulary 

DEPB 0 
TMPST0 DEPB 0 

ORG 27430 

X0R A; clear 

LD C.SOO 

LD ( PIICHT1 ),A 

LD ( PHCNT2), A 

LD (PHCNT3),A 

LD (PII1 END ) , A 

LD (CUHPHR), A 

LD HL.S6CCA 

LD (V0CADD),HL 
NXTPHR LD A,(CIIRP!IR) ; count phrase 

INC A; update and store 

LD (CURPIIR),A 

LD HL.S6C34 ;phrase buffer 

LD DE, ( V0CADD) ; cur rent location In voc 
PHRM0V LD A , ( DE) ; get character to move 

LD ( ML) , A; store it 

C P $ SE : " * " ? 

JP Z , MOVDONjphraae moved 
CP $5D; M ] M ? 

RET Z; yes-end of phrases 
INC HL; inc to store 
INC DE; inc to get 
JP PIIRM0V; move another 
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27484 


:6B5C 


13 






.'OVDO 1 


I?1C 


27435 


:6-"5? 


:d 


5 ' : 


1.1 £B 




',P 


37439 


6361 


i i 


4^ 






U) 


27492 


6 1164 


0? 


n.) 






ld i 


274 94 


:6 3b 6 


21 


34 


6C 




Li) 


27 4 97 


16369 


06 


00 




iUTCHri 


Ud ' 


27499 


bUbii 










o'X 1 


ZTjQO 


u 5bC 


A7 








AIID 


27501 


oooD 




42 






.J DC 


27503 


6B6F 


S3 








EX I 


27504? 


6 D70 


ot; 


00 






LD : 


7V} 06 ! 


b 372 


1 A 






7X7HAG 


LD 


27507 


6B73 


47 








LD 


27508 


6374 


7d 








LD / 


77509: 


6B75 


PR 


5K 






CP ', 


2751 1 : 


6B77 


51 


97 


6P 




jp : 


^514 : 


6«7A 




t * 


5" 




T ,p 


27517: 


6D7D 


78 








LD / 


275 in 


6B73 


?S 


53 






CP 


275 2U 


b BOO 


OA 


3F 


6 1) 




JP . 


275 23: 


b B8 5 


5A 


1 o 


oB 




L#D / 


27526 


G B86 


B8 








CP 


27527 


6 B^7 


CA 


91 


61 




jp ; 


.77530 


6B8A 


21 


M 


6'' 




LD I 


27553 


u38D 


1 3 








I iJC 


375?4 


6B8C 


C3 


69 


6 0 




JP . 


275 ; : 7 




?^ 






IA7CH1 




27") 


<>*>2 


1 * 








i m 


!75 5" J 


•> r: ? 3 










IIC 


27S40 






12 


6H 




J" . 


27543 


•uj^7 


5A 


1 1 


6B 


PMHDOii 


LD / 


27546 


6P9A 


^6 


Pf 






AJD 


27 5 48: 


bH9C 


C2 


B4 


6B 




JP ! 


275 51 


binr 


3A 


1 0 


o3 




LD / 


27 5 5 4: 


6BA2 


32 


1 1 


6B 




LD ( 


275*7 


6FA5 


21 


48 


6C 




LD 1 


275 60 : 


(> BAd 


;3 








•X I 



VuCAD!) ) , Of] ; store poinW 

" f .16C48; input u.IJr 
! f I**00; ^ero natch counter 

L, '.6034 ; phrase buffer 
l,0O0;only C w/»/'s 
> -J, ML; false start -back up 

A; clear carry 



2 o u n t e r 



natch 



Miarn 



MAC 



start of input buff* 



275 61 :b BA9 A7 
27 5 6 2 : 6BAA KD 5 •? 
275b4:61UC liD 
775 6 5:<jBAD 7B 
27566: 6 BAE 32 0* *"> ii 
27 r i60:6n^1 0*? V 6 ! < 
27572: b JB4 *A 1 2 6H 
27575 :6BD7 36 FP 
27577 :uBB9 C2 C5 bi3 
27^dU :uBBC 3 A 10 oil 
27583:bBBF 32 12 6U 
27586: 6 BC2 C3 3P 6B 
27589: 6 BC5 3 A 10 6B 
275 )2: bBC3 32 13 ui) 
27595: 6 BCD C9 
27700:6034 
27700:60 34 0 
27720:60 48 
27720:6048 0 
27H50:bOCA 
27850: 6CC A 0 



A.iD A ; (clear carry J 
S*C ifL.D-: 

■v. D 5, !L; local ion of U 
\ ) \ , kiutotn i * 
ld [ ?:n riD) ,a 

MSIDPM LD A , ( PHCHT2 ) ; already ' 
AMI) 

JP J Z f T'lHDf'M 
LU A,(CUtl?tlHj 
LD ( P^i0'i7:. , ) l A 
JP IX7PMR 
TIIPvDPII LD A, (CUHP'i:0;3rJ outc 
LD ( PHCHT3 ) , A 
RET ;3 plenty 

oaa 27700 

VUODUF DKP'J Ojpiirase buffer 

ORG 27720 
IIIBUPP Dh!FB 0; input buffer 

OrtO 27850 
VOCADU D::FD 0 ; vocabu 1 ary 
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Error messages and condi t ion checks 

An essential part of adventure games is that various 
events depend on what the player has already done. Lines 
700-999 check for whether the player's input is valid and 
whether certain conditions have been met. 

It is here that we will start assigning a value to the 
string called m$. Remember in the feedback section that m$ 
(for "message string") was printed out to tell the player 
what was happening. 

First, line 700 checks to see if two words were used. 
If there was no second word that exists in the vocabulary, 
line 700 sets m$ to "That's silly." Remember that we will 
have plenty of chances to change m$ before we report back to 
the player. Thus, if the player enters a single letter, 
such as N, to go north, line 700 will set m$ to "That's sil- 
ly" even though the input was valid. Later we will override 
this with a new version of m$ . 

Line 730 checks several things. If there is no verb or 
the first word in the input is not in the verb vocabulary or 
if the second word in the input (ob) is in the verb list, m$ 
says "You can't (whatever the player input)." 

Line 740 checks if the player is carrying the named ob- 
ject. This m$ message will be replaced later in most cases. 

Lines 825-860 are one condition check from Bomb Squad 
and are included here as an example of the kinds of things 
you should put in this part of the program. Bomb Squad is a 
time-limited game, so t (for time) is incremented each move 
the player makes. As soon as t1 (for timefl) is passed, the 
first bomb explodes, with GOSUB 5100. Similarly for t2 and 
t3. In Bomb Squad, the third bomb is a killer, so the rou- 
tine at 5300 ends the game. This kind of condition check 
permits a lot of interesting variation. For example, in 
Bomb Squad, there are actions the player can take that cause 
time to be wasted (you'll have to figure out how yourself). 
The passage of time can be simply marked by adding some num 
ber to the variable t. 

You will need lines 900-999. The parser has given you 
the number of the right verb, and in a moment you will want 
to branch to the routine that handles the activity called 
for by that verb. We have lots of verbs available, in order 
to make the game more interesting, but many of the verbs 
have roughly the same meaning and will call for the same 
verb action routines. In other words, the player might want 
to "search" or "examine" or "inspect" or "explore" etc. If 
the game permits only one of these words, it can be very 
frustrating to the player who has to make many guesses to 
get exactly the one word used by the author. Adventure Cre- 
ator permits many such words to be used, but the parser will 
give each of these words a different value (in the variable 
vb). We need to see that all of these similar words have the 
same value for getting to the right verb action routine. 
Thus, for example, in the verb vocabulary, the words like 
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"search" are verbs numbered 19-24. If the input verb was 
one of these, line 920 will set vj (for verb jump number) to 
6. You will soon see that verb action routine 16 deals with 
all "searching" verbs. You can apply the same pnnicple to 
each of the lines that sets a value for vj. To figure this 
out, you will have to keep referring to the vocabulary data 
list in lines 9115-9370. 



Verb act ion rout ines 

In many ways, this section is the heart of the adven- 
ture game. The player's verb input tells what is to be 
done. Each verb (or similar group of verbs) has its own set 
of permitted actions. 

Line 2000 returns with no action if no verb was found-- 
-m$ will say "You can't (whatever the player input)". 

Line 2005 is a condition check from Bomb Squad. This 
condition check had to be put here because it is one that 
permits only two ac t ions--dropping something or checking 
what one is carrying. If the player got weakened in the 
game, his or her carrying capacity (tl for "total load in 
Bomb Squad) was reduced. Thus, in order to continue, it may 
be necessary to drop something. The condition check must 
permit the player to get to the verb action routines in or- 
der to drop something, but line 2005 permits only verb ac- 
tion routine 2(carrying?) or 11 ( drop, throw . dump, re lease , or 
leave) We have gone into detail on this line as an example 
of the kind of condition checks you will want to develop in 
your own games. 



Jumps lo ve.r£ rout ines. 

Lines 2010 and 2030 use vj to jump to the appropriate 
verb action routine. Note how we have numbered the lines 
here. The first verb ("help") is at 2100, the second 
("carrying?") is at 2200 etc. This permits you to find your 
way around your program more easily. A hundred line numbers 
are plenty for each verb routine. and your program will be 
much more readable and easy to modify if you use some ra- 
tional line numbering system. 



• Line 2100- Help. . 
If you're hard hearted. you may want to leave out this 
routine. The player can ask for help and have the entire 
vocabulary listed on the screen. This might be considered 
cheating. since seeing the vocabulary usually gives huge 
hints on solutions to problems. Por example, in Bomb Squad, 
seeing the verb "blackmail" practically gives away one solu- 
tion. 
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Line 2110 skips through all the data statements until 
it finds the first vocabulary word. Then line 2120 reads the 
vocabulary until it finds "zz", at which point it quits. 
The variables wc (for word count) and hp (for help) keep 
track to be sure only 4 words per line and 16 lines per 
screenful are printed, so the screen will be readable. 



Line 2200- Carrying ? . 

Line 2210 skips through the data statements to the last 
verb. Then line 2220 checks the c( ) array to see if each 
"gettable" item is being carried. If it is, the object name 
is printed. 



Line 2300- Go. 

The movement routine is so important, it is practically 
a small program in its own right. First, we must determine 
the direction the player wants to go. If the player input 
just N, S, W, or E, line 2300 will set variable d (for di- 
rection) to I, 2, 3, or 4 by subtracting 3 from the verb 
number vb. These letters are items 4-7 in the verb list. 

Now you will see why the words "north", "south", 
"west", and "east" are included in the vocabulary as "ob- 
jects" or nouns. We permit the player to say things like "go 
south" or "crawl east". Thus, the verb will be "go" and the 
object will be one of the directions. In this case, lines 
2303-2312 will set d correctly. 

Following the setting of d, you should include some 
condition checks relating to player movement. Line 2344 is 
one such check included from Bomb Squad as an example. (If 
you want more examples, list out Bomb Squad.) In this exam- 
ple, the player is at the front door and has not yet "disa- 
bled" the guard, which the program knows because the "flag" 
for the guard (f(45)) is still zero. If the player tries to 
go north (d-1) or east (d*4) under these circumstances, m$ 
is set to "The guard won't let you pass", and nothing is 
permitted to happen because the RETURN, terminates the verb 
ac t i on . 

Lines 2370-2388 check to make sure the player isn't 
trying to walk through a wall. Remember that the route ar- 
ray r$( ) contains the permitted directions of movement for 
each location. We are going to use "flag" 19 (f(19)) tempo- 
rarily here because we won't ever need it to keep track of 
events--why 1 , because "object" H9 is really a direction 
name. The FOR NEXT loop in lines 2372 take each letter from 
r$( ) for the current location. For example, if the player 
is in "room" 112, and room fl 2 has only doors at north and 
south, then r$(12) will be "NS". If the player is trying to 
go north, line 2376 will determine that d« 1 and N is permit- 
ted in room #12; f(19) will be set to 1. However, if the 
player is trying to go east, d will equal 4 and line 2382 
will fail, since the letter E is not in r$(12). Thus, f(19) 
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will not get set to 1. If this is the case, 1(19) will still 
be zero, and line 2388 will set m$ to "Can't go that way! . 

Now return to lines 2376-2382. When the IF condition 
succeeds, the room number gets changed. Now you can see why 
the "world" of your adventure game is laid out in a square 
arid When the player moves north, the new room number is 
exactly 6 less than the old one (assuming you're using a bxb 
arid, as in Bomb Squad). Moving south adds six to the room 
number, east adds one. and west subtracts one. 



Line 2400- Get . . t . 

T^e M get" verbs are another essential verb routine. 
The player must acquire and discard items to so 1 ve problems . 

If the player says something like "steal guard and you 
have not included the guard as a "gettable" object. line 
2400 will prevent the action. Line 2420 checks if the pl«y«r 
is in the same room as the object. Line 2430 checks if the 
object is vi»ibl«~ il the object's flag is set to 1 it is 
likely hidden or invisible. if magic is at work. It the 
player is already carrying the object. line 2440 takes care 

° l 1 Line 2452 is usually necessary to force the player to 
use strategies. If there is no limit to the objects that 
can be carried. the player will simply pick up 
Here variables tc (for total carried) and tl (for total 
load) keep track of things. If the load is at maximum the 
action is prevented by RETURN i ng the player without taking 
action. in this example, tl may change depending on whether 
the player has been weakened in previous game action. Bomb 
Squad starts with tl set at 4 items maximum to be carried. 
This»qives some flexibility but also requires careful dec i 
sion making. since the player isn't sure what circumstances 
will be encountered. *k.- m 
Line 2460 checks all the required conditions and then 
grants the player the item being sought. 

Line 2470 is specific to Bomb Squad, but it is included 
here because it illustrates the solution to a common prob- 
lem. The verb "take" is included as one of the get verbs, 
but in Bomb Squad. it can also be sensibly used in take 
pictures". This line gets around the problem. Your problem 
is going to be that you will have to anticipate how your 
players might use different words in ways you don t antici- 
pate. Probably your best strategy here is to play your own 
game many times. putting yourself in others s shoes. Then 
have some friends play the game while you take notes on such 
problems . 



Line 2500-- Op.cn . 

A cc^oTTadventure verb. open is used many -ys de- 
pendent on your particular story line. Lines 2500-2590 dem- 
onstrate several condition checks. to see if the player has 
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the necessary tools (or magic spells or keys or whatever) to 
open the door. Line 2530 is included to illustrate a new 
technique. In this instance, the only permitted directions 
of movement in room 130, were N and W. However, after the 
player unlocks a door, south is also permitted, so r$(30), 
which holds the permitted routes for room f30 is changed 
from "NW" to ** NSW . 



Line 2600-- Examine . 

Another very useful set of verbs are the search/examine 
ones. Line 2600 checks if the player is in the same room as 
the object and sets m$ to "Nothing spec ia 1 -- just a (whatever 
the object is)". Of course, if it is something special, we 
will soon change m$ to something else. For example, line 
2630 determines that the player said, "examine garbage", so 
m$»"That , s disgusting!". (Try to catch the player off guard 
and be amusing sometimes.) Line 2640 illustrates what hap- 
pens if something hidden is discovered. The player has 
said, "search grass" and discovers a crowbar. Thus f(2) -- 
the crowbar "flag"-- is set to zero, since it is now visi- 
ble—that is, "normal". 



Lines 2700-3000 . 

These verbs (read, decode, defuse, unlock/pry) are 
fairly specific to the Bomb Squad game. You may be using 
other verbs here. The sample lines provided are fairly easy 
to figure out. 



Line 3 1 00-- leave . 

Verbs like "leave" and "drop" are essential, if you 
have used "get" verbs and limit the amount the player can 
carry . 



Lines 3200-3400 . 

More specific verbs (light, extinguish, fight). One in- 
teresting point here is that the verb "unlight" is ungram- 
matical but commonly accepted in adventure games, since we 
don't have a common verb that means turn off the light. How- 
ever, you and we are erudite gamers and prefer to use accu- 
rate- even if esoter ic--words , like "extinguish". Impressed? 
Another point is that this action is absolutely useless to 
the player in Bomb Squad. However, useless actions and use- 
less objects must be scattered through the game to force the 
player to think through what really matters. 



Line 3500-- Use. 

Although this verb is absolutely essential, try to use 
it sparingly. Adventure games sometimes get simplistic and 
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boring by making the player say things like "use keys" and 
not permitting "unlock door". The more specific language is 
more interesting. However, some things do not lend them- 
selves easily to one-verb commands. For example, you might 
have to say "use crowbar", since we don't have a good crow- 
bar verb. Bomb Squad gets around this at one point by per- 
mitting H pry door" if the player has the crowbar. 



Lines 3600-4 100 . 

Some lines from Bomb Squad are included for these 
verbs to illustrate the verbs--move, drink, break, talk, 
feed, blackmail/bribe, and show. 



Lin e 4600-- SAVE . 
, The SAVE command is not essential, but better games in 
elude it, and it greatly adds to the player's pleasure. 
Some people actually have to work for a living, and it can 
be pretty frustrating to have defeated the Lord of Darkness, 
cross the Mystic Threshhold, prepare to decode the magic 
code and have the boss call to find out why you're late 
again. A game in progress can be SAVEd to be completed lat- 
er. It is also smart to SAVE a game as you are playing it. 
Then if you get killed or are in a hopeless situation (per- 
haps you can no longer carry anything) . you can quit, RUN 
the game again, and re LOAD the game as you were when you did 
the last SAVE. 

This and the "load" routine illustrate the general pro- 
cedures for interacting with tape or disk drives with the 
ADAM. Line 4610 opens the file. In this case, the file will 
be named "bombgame", but you will want to use some other 
name. If you want to permit the player to SAVE the game un- 
der many different names, include an INPUT line somewhere 
that permits the player to assign a name (up to 10 charac- 
ters long) to the variable f$ (for file string, although you 
can use any variable name, or course). In this case, line 
4610 would be exactly as follows. 

4610 print chr $ ( 4 ) ; "open " ; f $ ; " , d" ; dr $ 
This creates the equivalent of the current line 4610 with a 
different file name. Remember that dr$ determines whether 
you will be saving to tape or disk. In line 50, we set 
dr$«1. This is for tape. If you want a disk version of your 
game, set dr$ to 5 in line 50. 

Line 4620 prepares BASIC to write to the file. Lines 
4630 use PRINT statements to write all the important vari- 
ables. In this circumstance, the PRINT command writes to 
tape or disk because of the PRINT chr$(4) in line 4620. 

Note that line 4695 terminates the SAVE and has the 
same general format as the opening line, 4610. If you per- 
mit f$ for different file names, make line 4695: 
4695 print chr $ < 4 ) ; "close " ; f 5 ; H ,d" ;dr $ 
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Line 4700-- LOAD . 

when the player inputs simply the verb "load", the pro- 
gram looks for a file named "bombgame" or whatever you 
change this to for your own games. 

Note that this routine is exactly like the SAVE rou- 
tine, except we say "read" instead of "write", and INPUT 
rather than PRINT. It is essential that the variables be 
INPUT in exact ly the same order as they were SAVEd or, of 
course, they will have the wrong values. If you use f$ for 
the file name, make Line 4710 just like 4610 and line 4795 Q 
just like 4695. (Notice how we are using parallel line num- 
bering to make the program easier to understand and modify.) f 



GRAPHICS 

Lines 6000-7799 have been reserved for graphics rou- 
tines. Graphics routines in BASIC take up quite a bit of 
memory, but they are really worth it. Using visual clues in 
pictures adds a lot to adventure games. The ADAM has some 
pretty spectacular graphics capabilities, but BASIC makes 
them hard to use. Once you understand these sections on 
graphics, you should be able to draw high resolution pic- 
tures and use up to 32 sprites--but more on this later. 



Using HPLOT for " bui ldinq blocks " b 

Your general strategy is going to be to draw line draw- 
ings using small subroutines as "building blocks", place 
sprites around your picture, and then animate the sprites. 

Examples of "building blocks" can be found in lines rt 
6000-6055. Lines 6000 and 6010 draw the interior lines of a 
room in "3D" perspective. These two lines assume that some- 
where else in the program you have gotten into high resolu- ao 
tion mode (with lines of text at the bottom of the picture) 
with a HGR command and have set HCOLOR to some value. Then \o 
you use GOSUB 6000 to draw the room walls. To portray dif- 
ferent rooms, just use different HCOLOR' s. 9 

Line 6030 is a similar routine that draws a 4-pane win- 72 
dow in whatever HCOLOR was set last. The upper left-hand 
corner of the window will be at coordinates x and y. X and y 
must be set before this line is called with a GOSUB. X is 
the horizontal value and Y is the vertical value. This per- 
mits you to draw windows anywhere on the screen and to 
"stack" these windows on top of each other for big windows. 

By the way, let us save you some f rustrat ion--or at 
least prepare you for it. The command HPLOT 100,50 to 150,50 
should always draw a straight horizontal line. Sometimes, 
for reasons best known to the writers of smartBASIC, there 
is a jog in the line, so you have to use something like 
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HPLOT 100,50 to 150,49 to get a straight line. The 
subroutines included in Adventure Creator are adjusted for 
this, but you will probably run into the problem when you 
'make your own "building blocks". 

Line 6040 draws a door at the back of the room drawn by 
line 6000. 

Line 6050-6055 draws a side window, in perspective, on 
the right hand wall of the room drawn by line 6000. As with 
the rectangular window, you need to set x and y coordinates 
before calling this subroutine. 



Plott ing your drawing^. 

In order to use HPLOT to draw pictures it is essential 
to prepare graph paper marked from 0 to 255 along the hori- 
zontal axis and 0 (at the top) to 159 along the vertical 
axis. Draw in the major lines of your scene and determine 
the points for starting and ending your HPLOT commands. 



Prawjng the flc gn g 

The more "building blocks" you have, the easier it is 
to draw a scene, but there will usually be unique parts to 
be drawn for each scene. Bomb Squad and The Visitor both 
use graphics to illustrate four scenes. One of the scenes-- 
the view of the front of the embassy-will be analyzed here 
as an example. If you want more examples, of course, you 
can list the sections from 6000-7799 in each of the other 

programs^ BASIC to the HGR mode, which is high 

resolution graphics, with room reserved at the bottom of the 
screen for lines of text. For our purposes, this is the 
best mode, so we can ask the player for input while the pic- 
ture is still on the screen. 

Line 6203-6205 sets HCOLOR and x and y and draws win- 
dows by GOSUB 6030. Lines 6210-6230 use HPLOT's to draw in 
building outlines, driveways, and a garage. 



Using apritsa 

Now comes one of the most interesting (and probably 
most complicated) parts. But hang in there, sprites will be 
worth understanding. 

One of the most powerful graphic tools on the ADAM is 
the 32 sprite capability available. A sprite is a high res- 
olution figure that can be 8x8 bits or 16x16 bits in size. 
Each bit is one dot on the screen, and remember that in high 
resolution, there are 256 dots horizontally and 159 dots 
vertically. So a 16x16 sprite will occupy about 10\ of the 
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picture from bottom to top. We find that a human figure 
should thus be made up of two 16x16 sprites (one on top of 
the other) to be proportional to an interesting picture on 
the screen. The sprites can also be in a magnified mode, so 
that an 8x8 becomes 16x16 and the 16x16 sprite becomes 
32x32. The problem with the magnified mode is that the res- 
olution looks much cruder — that is, each dot now looks like 
a small square, so the pictures don't have as professional a 
look. 

For now, don't worry about how to make a sprite a par- 
ticular shape; we will deal with that later. Just under- 
stand how they look on the screen. Each sprite is a small 
picture that can be instantly moved anywhere on the screen 
simply by setting two numbers, which will be the coordinates 
of the upper left hand corner of the sprite. In addition to 
being instantly moveable, each sprite has a certain priority 
of being visible. The sprites are numbered from 0-31, and 
the lower the number, the higher the priority of being visi- 
ble. Thus, if sprite 1 and sprite 7 are moved to the same 
place on the screen, sprite 7 will be hidden "behind" sprite 
1. Even better, if part of sprite 1 is not colored in, that 
part will seem transparent, and we will be able to catch 
glimpses of sprite 7 behind it, through the transparent 
parts of sprite 1. These characteristics permit very complex 
"3D" effects without complex programming. 

Any one sprite can be only one color, but these charac- 
teristics give us ways to make multicolored objects on the 
screen. An example is the woman who appears and disappears 
in the guard house in Bomb Squad (and is included as an ex- 
ample in Adventure Creator). She has peach-colored skin and 
yellow hair. She is made up of two sprites, one yellow and 
one peach. She is drawn so that the "skin" sprite is trans- 
parent where her hair goes and the hair sprite is transpar- 
ent where the skin goes. Actually, both sprites are trans- 
parent around the edges too, so you can see the guard 
"behind" her. Obviously, this means that the guard is made 
up of sprites with higher numbers than the sprites that make 
up the woman. When she moves, we simply move both the 
"skin" and "hair" sprites simultaneously. If you want to 
get cute, you could draw her as bald in sprite 14 and draw 
her hair in sprite 13. Then as long as both sprites move 
together, she will have her hair, because sprite 13 has pri- 
ority for being visible, and her bald head would be hidden 
behind the hair. Then if you move only the "hair" sprite, 
her "wig" would come off. Then you could change her skin 
color, as she flushes with embarrassment. Let your imagina- 
tion run. 

You probably won't run into this, but only 4 sprites 
can be on any one line of the screen at a time. Nothing 
disastrous occurs, but if more than 4 sprites have the same 
vertical coordinate, parts of some of them will fade in un- 
predicatable ways. 



37 



Satin fl a *g 

Learning how to create sprite shapes will not be easy, 
unless you already understand things like hexadecimal num- 
bers and the bit patterns used by computers. We will try to 
make the necessary information understandable. 

Start with a grid on paper that corresponds to the size 
of sprite you want. We much prefer the 16x16 sprites with- 
out double-size magnification. They do consume a lot of 
memory, but they are also of a more use f ul s i ze on the 
screen than the 8x8 sprites, and they look better than the 
magnified sprites. Our example is of a 16x16 sprite, but 
the same principles will apply to 8x8 if you prefer them. 

The 16x16 grid in the following figure shows how we 
created the two sprites for the woman. First sketch in the 
parts, in this case the skin and hair, lightly. The squares 
of the grid containing hair we filled in with the letter H. 
(Actually, we did the original picture with colored pencils, 
which made it easier to visualize.) The skin squares are 
marked S. Since the woman is to appear only in the top ot 
the guard house. we will need only the top part of her pic- 
tures-otherwise we would have needed another two sprites 
(for skin and clothing) for the bottom half of the picture. 

Now that the grid contains H's and S's and blank spots 
we can fill in two separate grids, one for hair and one for 
skin, each representing one sprite. 

Now comes the hard part. We have to determine the num- 
bers that the computer will understand as the correct pat- 
tern of bits for our picture. Draw a vertical hne down the 
middle of the grid, so you have two columns, each 8 boxes 
wide! There are 16 rows of boxes in each column Each row 
of 8 boxes will be represented by one number from 
The computer represents numbers as patterns of 8 ones or ze- 
ros, using binary notation. Wait! Wa i t ! Don t stop reading 
We are not going to require you to understand binary and 
hexadecimal numbers. If you already understand these things 
you will not need the next table and can assign numbers 
based on the bit patterns in your drawings. f you don t. 
just use the following table, which gives you the bit pat 
tern" of every number from 0-255. 

Let's create the "hair" sprite as an example. We need 
32 numbers-in this order. Sixteen numbers th ** "P''""' 
the left hand column of rows of eight boxes. followed by 
sixteen numbers that represent the right hand column. (Each 
It these numbers will be a "byte".) The first row n the 
left hand column is all blanks, so the first number will be 
zero. The second number will be 3 l«0 *U1 provide the 
hexadecimal numbers in parentheses here-- for his one 
The third number is 7 <07H>, fourth is 6 (06H), and fifth is 
12 (OCH) You can refer to the diagram and to the bit pat- 
tern table to understand how the rest of the numbers were 
determined for the hair sprite and for the skin sprite. 
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no. 
0 
3 
7 
6 
12 
12 
12 
108 
106 
60 
28 
12 
0 
0 
0 
0 















































// 


i 


d 


i 


a 


t 




















ti 


tt 




fi 




it 


H 


tt 


li 
















t* 


tt 












It 


H 


/+ 












i 


It 
















tt 


H 












fi 


it 
















ft 


It 












ft 


it 
















ft 


tt 






ti 


if 




a, 


ft 
















It 


It 






H 


if 




,t 


ti 
















ti 


H 








tt 




H 


if 
















it 


it 


ii 








it 


ti 


if 
















tt 


it 


H 










d 


(t 
















It 


H 



































































































































no. 
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252 
252 
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6 
6 
6 
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7 
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0 



Diagram of grid for "hair" sprite. Numbers are taken from 
The Bit Pattern Table and correspond to the DATA in line 
number 99 1 *0-99 1 *1 • 
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49 



Diagram of grid for 
to the DATA in line 

















































































































> 


i 


5 


•? 


> 




























'? 






? 




















b 


V' 




> 


5 


> 


> 




















5 




■? 


5 


























>" 


> 








> 


























> 


? 


> 






























? 






























> 


































? 


.5 




















j 


? 


5 


> 




? 








% 






















i 




1 


! 


5 














5 












> 
















> 


$ 








> 


"? 




> 


* 3 ' 








> 



0 
0 
0 

240 
88 
248 
248 
16 
224 
192 
224 
224 
252 
252 
246 
243 



•skin" sprite. Numbers correspond 
number 9943-9944. 



41 



40 



BIT PATTERN TABLE 



no . 


pa 1 1 e r n 


no . 


pattern 


no . 


pa 1 1 a rn 


no • 


pa 1 1 a r n 


000 


00000000 


064 


01000000 


128 


10000000 


192 


1 1 000000 


001 


00000001 


065 


01000001 


1 29 


10000001 


193 


1 1 00000 1 


002 


000000 10 


066 


01000010 


1 30 


1 0000010 


1 94 


1 1 0000 1 0 


003 


0000001 1 


067 


0100001 1 


1 3 1 


1 000001 1 


1 95 


1 1 0000 1 1 


004 


00000 1 00 


068 


01000 100 


1 32 


10000100 


1 96 


1 1 000 1 00 


005 


00000101 


069 


01000101 


1 33 


1 0000101 


1 97 


1 1 000 1 0 1 


006 


000001 10 


070 


010001 10 


134 


1 0000 1 1 0 


1 98 


1 1 000 1 1 0 


007 


00000 1 1 1 


071 


010001 1 1 


1 35 


1 0000 1 1 1 


1 99 


1 1 000 1 1 1 


008 


0000 1 000 


072 


01001000 


1 36 


1 0001000 


200 


11001 000 


009 


0000 1001 


073 


01001001 


1 37 


1 000 1 00 1 


201 


1 1 00 1 00 1 


0 1 0 


0000 1010 


074 


01001010 


1 38 


1 000 1010 


202 


1 1001010 


01 1 


0000 1011 


075 


0100101 1 


1 39 


1 000 1011 


203 


11001011 


0 1 2 


0000 1 1 00 


076 


0 1 00 1 1 00 


140 


1 000 1 1 00 


204 


11001 100 


013 


0000 1101 


077 


01001 101 


1 4 1 


1 000 1101 


205 


1 1001 101 


014 


0000 1110 


078 


0100 1 1 10 


142 


1 0001 1 1 0 


206 


11001110 


015 


0000 1 1 1 1 


079 


0 1 00 1 1 1 1 


143 


1 000 1111 


207 


11001111 


016 


000 1 0000 


080 


0101 0000 


1 44 


1 00 1 0000 


208 


110 1 0000 

1 1 V 1 V V V V 


017 


0001 000 1 


08 1 


0101 0001 


1 4 5 


1 00 1 000 1 


209 


110 1 000 1 

1 IV I V V V 1 


0 1 8 


000 1 00 1 0 


082 


01010010 


1 46 


10010010 

1 V/ V 1 V V 'V 


2 1 0 


110 1 00 1 0 

1 1 V I V V 1 V 


0 1 9 


000 1 00 1 1 


083 


01010011 


14 7 


10010011 

1 V V • V V • ' 


211 


1 10 1001 1 


020 


000 10100 


084 


0 10 1 0 1 00 


1 48 


1 00 10 100 


2 1 2 


110 10 100 

1 1 V 1 V 1 V V 


021 


000 10101 


085 


01010101 


1 49 


10010101 

1 uu I V IV » 


2 1 3 


1 1010 10 1 

• i V » V • V 1 


022 


000 10110 


086 


010101 10 


1 50 


10010110 


214 


1 10 10 1 10 


023 


000 10111 


087 


01010111 


1 5 1 


100101 1 1 


2 1 5 


11010111 


024 


000 1 1 000 


088 


01011 000 


1 52 


10011 000 


216 


1 ioi innn 

' IU l l v \J v 


025 


0001 1 00 1 


089 


010 1 1001 

v ■ v • » v v i 


15 3 


i no i iooi 


217 


i ini 1 n n i 


026 


0001 1010 


090 


0 10 1 10 10 

V i V i • v i v 


1 54 


100 1 10 10 


~> 1 A 


1 1 n i 1 n i n 

1 1 \J 1 1 V 1 V 


027 


0001 1011 


091 


01011011 


1 55 


10011011 


2 1 9 


11011011 


028 


000 11100 


092 


010 11100 


1 56 


10011100 

1 V V 1 1 1 uu 


220 


1 101 1 100 


029 


000 11101 


093 


01011101 


15 7 


10011101 


2 2 1 


11011101 


030 


000 11 110 


094 


01011110 


1 58 


10011110 


2 2 2 


11011110 


031 


000 1 1 1 1 1 


095 


01011111 


1 59 


10011111 


22 3 


11011111 


032 


00 1 00000 


096 


0 1 1 00000 


1 60 


101 00000 


224 


1 1 100000 
• i i v v v v \j 


033 


001 0000 1 


097 


0 1 1 0000 1 


161 


101 ooon 1 

IV 1 V V V \J 1 


C £- O 


1 1 i n n n n 1 


034 


00 1 000 1 0 


098 


0 1 1 000 1 0 


162 


1 0 1 000 1 0 

IV 1 V V V ■ V 


226 


1 1 1 n nn 1 n 

I 1 l \J V V 1 V 


035 


00 1 000 1 1 


099 


01100011 

VI ' V V V 1 1 


163 


ioi onn 1 1 

1 V 1 U V V 1 1 


9 5 7 


1 i innm i 


036 


001001 00 


1 00 


01100100 


1 64 


10100100 

IV • V V 1 V V 


228 


111 no 1 nn 

1 • 1 V V • V V 


037 


00100101 


101 


01 100101 


165 


10100101 


229 


1 1 1 00 1 0 1 


038 


001001 10 


102 


01 1001 10 


166 


101001 10 


230 


1 1 1001 10 


039 


001001 1 1 


103 


01 1001 1 1 


167 


101001 1 1 


231 


1 1 1001 1 1 


040 


00101000 


104 


01101000 


168 


10101000 


232 


1 1 101000 


041 


00101001 


105 


01101001 


169 


10101001 


233 


1 1 101001 


042 


00101010 


106 


01101010 


170 


10101010 


234 


11101010 


043 


0010101 1 


107 


01101011 


171 


10101011 


235 


11101011 


044 


00101 100 


108 


01 101 100 


172 


10101100 


236 


1 1 101 100 


045 


00101 101 


109 


01101101 


173 


10101101 


237 


11101101 


046 


00101 1 10 


110 


01101110 


174 


101011 10 


238 


11101110 


047 


00101 1 1 1 


111 


01101111 


175 


10101111 


239 


11101111 


048 


001 10000 


112 


01 1 10000 


176 


101 10000 


240 


1 1 1 10000 


049 


00110001 


113 


01110001 


177 


101 10001 


241 


1 1 1 10001 


050 


001 10010 


114 


01 1 10010 


178 


101 10010 


242 


11110010 



051 
052 
053 
054 
055 
056 
057 
058 
059 
060 
061 
062 
063. 



0011001 1 
001 10100 
001 10101 
001 101 10 
00110111 
001 1 1000 
001 1 1001 
001 1 1010 
001 1 101 1 
001 1 1 100 
0011 1 101 
001 1 1 1 10 
001 1 1 1 1 1 



115 01 1 1001 1 

1 16 01 1 10100 

117 01110101 

118 011 10110 

119 01110111 

120 011 1 1000 

121 01 1 1 1001 

122 01111010 

123 01111011 

124 01111100 

125 011 1 1101 

126 01111110 

127 01111111 



179 


101 1001 1 


243 


1 1 


1 1001 1 


180 


101 10100 


244 


1 1 


1 10100 


181 


10110101 


245 


\ 1 


110101 


182 


10110110 


246 


1 1 


110110 


183 


1011011 1 


247 


1 1 


110111 


184 


101 1 1000 


248 


1 1 


1 1 1000 


185 


101 1 1001 


249 


1 


1 1 1001 


186 


10111010 


250 


1 


1111010 


187 


10111011 


251 


1 


1111011 


188 


10111 100 


252 


1 


1 1 1 1 100 


189 


1011 1101 


253 


1 


1111101 


190 


10111110 


254 


1 


1111110 


191 


10111111 


255 


1 


1111111 
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Sprite 9>ta alraliaill- 

Adventure Creator includes the sprites actually used in 
the Bomb Squad game to illustrate some programming princi- 
ples and to provide you with a starting point. Once you un- 
derstand this part, you will be able to use some of the 
sprites from The Visitor if you prefer them. 

The lines 9901-9959 contain the data for drawing the 20 
sprites from Bomb Squad. Each two lines of data represent 
one sprite. Each data line contains 16 values. the first 6 
lines of data are all 255. This creates three sprites that 
are solid blocks — sprites #0, fl, and 12. These three 
blocks can be made various colors for use in many different 
scenes. For example, one block is the bottom half of the 
guard house in Bomb Squad, and all three blocks are used to 
make up 3/4 of the gate in the. picture of the dog's yard 
scene. Two blocks are used as furniture in the library 
scene, and they also serve as crates in the storage room 
scene. These blocks are put in low-numbered sprites so we 
can hide things behind them. In the guard house scene, for 
example, the woman is hidden in the bottom of the guard 
house until she appears. 

The next two sprites (lines 9910-9914) are empty 
squares that can also be used for different scenes. For ex- 
ample, as the top of the guard house and as crates in the 
storage room. 

Lines 9916-9917 are the top of a bookcase that is set 
on top of one of the solid blocks to make a bookcase in the 
1 ibrary . 

Lines 9919-9920 are a round bush that can also be used 
as the top of a tree. 9922-9923 are a leafy bush that can 
also be the top of a tree. 9925-9926 is a tree trunk. Of 
course, these three sprites can be used in different combi- 
nations with each other and in different colors to create 
different species of trees. 

9928-9929 is the "broken part" of the gate (the lower 
left corner) in the dog yard scene. 9931-9932 are the book 
and letter on the shelf in the library. 9934-9935 make up 
the main body of the car in the garage; 9937-9938 make up 
the trim, wheels and steering wheel of the car. Of course 
these two sprites always are placed in the same location. 

9940-9941 is sprite 113 (remember to start counting 
with 0), which is the woman's hair. 9943-9944 make up her 
face and shoulders. 

9946-9947 are the man's hair and shirt, and 9949-9950 
are his face. Note that these "face/hair" sprites could be 
used to make several different characters in different 
scenes by changing the color of hair and skin. 

9952-9953 is one picture of a dog, and 9955-9956 is the 
same dog with his legs and mouth in a different position. 
By switching between these two sprites and moving horizon- 
tally, you can animate the dog to be walking and biting. 

9958-9959 are the bomb in Bomb Squad. 
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As we noted in the section on initializing, all of 
these numbers must be POKEd into memory in exactly this or- 
der, starting at memory location 28850. 



Sprite attributes 

The control of each sprite depends on 4 numbers--the 
attributes of the sprite. Thus, for our 20 sprites, we will 
need 80 attributes. The first two numbers determine the lo- 
cation of the sprite on the screen; they are the coordinates 
of the upper left corner of the sprite. The first number is 
the vertical coordinate, and the second is the horizontal 
coordinate. (Note that this is opposite of using coordinates 
with HPLOT. where the first number is the horizontal coordi- 
nate.) The attributes of the 20 sprites in Bomb Game are in 
the data lines 8600-8625. Notice that in each group of 4 
numbers, the first two numbers are 200. This means that 
when the game is initialized, each sprite is at location 200 
(vertical) and 200 (horizontal). This is below the visible 
part of the screen, so the sprites are hidden, waiting to be 
used . 

The third attribute is the sprite number. If you are 
using 8x8 sprites, this number will simply be 0, 1, 2, or 
whatever the actual number of the sprite is. However, it 
you are using 16x16 sprites (as we are), the actual number 
you must use is the sprite number multiplied by 4. The rea- 
son for this is that ADAM uses this number to know where to 
look for the correct sprite date in the data table for de- 
termining shapes. The 8x8 sprites each use 8 bytes for 
data, but the 16x16 sprites use 32 bytes each. Thus, in the 
data statements in lines 8600-8625, the "sprite number at- 
tribute" of the first sprite is zero (sprite 10 times 4). 
The second sprite in the list is sprite ftl, so the "sprite 
number attribute" must be 4. The next "sprite number attri- 
bute" is 12 etc. 

The last attribute determines the color of the sprite. 
Unfortunately, the colors do not correspond directly to the 
color-numbers used in BASIC. 



sprite CQl or Attribute Tpbje 



Attribute f Color Attribute I Color 



0 


transparent 


8 


med. red 


1 


black 


9 


It. red/peach 


2 


med. green 


10 


dk yellow 


3 


It. green 


11 


It yellow 


4 


dk. blue 


12 


dk. green 


5 


It. blue 


13 


magenta 


6 


dk. red/orange 


14 


white 


7 


cyan 


15 


gray 
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Notice in the program that line 8630 sets the variable 
sa (for sprite attributes) to 29500, and then the sprite at- 
tributes are POKEd into memory starting at this location. 
We now have our "sprite attribute table" in place. Remember 
also that lines 8630-8660 are set up so that in the program 
we can use GOSUB 8630 to set all the sprite attributes to 
their initial state--with all of them hidden off the screen. 
The main way we do this is in line 280 — in the input section 
of the program. This line restores the screen to text, so 
if there is a picture there it will be erased. Just before 
it does this, it reinitializes all the sprite attributes and 
hides the sprites off the screen. If we did not do this, 
the next time we draw a scene, the old sprites would be vis- 
ible for an instant before we draw the new scene. 

You will also notice that line 280 includes CALL sr. 
This means to call the "sprite routine", which we will dis- 
cuss in a moment. 



Placing £h£ sprites in a scene . 

We are finally ready to put sprites in our picture. We 
can now return to line 6250 in the "framework program". Up 
to this point, we had used HP LOT to outline our picture. 
Line 6250 is going to POKE new numbers into the "sprite at- 
tribute table" at memory locat ion 29500; then we will call 
the "sprite routine" subroutine, which will move the sprites 
around and change their colors, depending on the numbers in 
the "sprite attribute table". 

The address of the "sprite attribute table" is given to 
variable sa (for sprite attribute). Thus, in line 6250, we 
see the command 

POKE se,95: poke sa*1, 160 

Let's understand these two POKES before looking at the 
rest of this line. POKE sa,95 puts the number 95 into the 
first location in the sprite attribute table. This will 
then become the vertical coordinate of the first sprite. 
POKE sa*1, 160 changes the second number in the table, 
which is the horizontal coordinate of the first sprite (re- 
member that the first sprite is #0). (Later, in line 6270, 
we will CALL sr, and sprite #0 will move onto the screen to 
become the bottom of the guard house). 

The next POKE sa*3, 14 changes the color of this sprite 
to white, which is the color we want for the guard house. 
Notice that we skipped one number in order to set the color. 
In each set of four attributes, the first two are always the 
location coordinates, the third is the sprite number (multi- 
plied by 4 if you are using 16x16 sprites) which you never 
change, and the fourth is the color number. Since sprite 10 



i 
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is used for many different purposes, we will have to change 
its color each time, depending on what it is supposed to be 
in the picture. 

The next POKE sa*16, 79 and POKE sa*17, 160 sets new 
coordinates for sprite I 4. How do we know that these are 
the coordinates for sprite 14? Simply by mutliplying the 
sprite number by 4. Then this number and the next one are 
the location coordinates. In this case we don't have to 
change the color number, because we set the color of sprite 
14 to white when we initialized the sprite attributes. 

After lines 6250-6265 POKE in all the coordinates and 
new colors wanted, line 6270 finishes the picture by CALL 
sr, the sprite routine. 



Animating Hi* sprites 

In our example scene, line 6275 checks to see if the 
guard has been "disabled". If he has, nothing further hap- 
pens (IF f(45)»1). However, if he is in his "normal" state 
(f(45)-0), then we have to animate the picture, to show that 
something fishy is going on in the guard house. The anima- 
tion shows the woman standing up to look out the window, 
quickly hiding and then looking out again before hiding for 
good. Very suspicious. 

Lines 6280-6295 animate the woman. Line 6280 sets up a 
FOR NEXT loop, so she will go through the movements twice. 
Then it sets up a FOR NEXT loop that will automatically 
change the vertical coordinates for the "hair" and "face" 
sprites that make up the woman. This loop goes from 95 to 
79 in steps of -3. 

In line 6286 we POKE sa*52, L and POKE sa*56, L ;then 
we call the sprite routine; then we stall briefly to smooth 
out the movement. Thus, the first time through, L will 
equal 95 and both the "hair" and "face" will still be hid- 
den. The second time through this FOR NEXT loop, L will be 
3 less, that is:92. Then the vertical coordinates of the 
"hair H and "face" sprites will be 3 higher, and the woman 
will start to rise in the window. 

As soon as the loop finishes a second one starts, with 
the woman hidden again, so it looks like she quickly ducked 
down . 

Line 6283 is simply included to put in a delay when she 

is hidden. ^ 

Line 6295 returns her to the hidden position before the 
RETURN from this graphics routine. 



The general principle 

Bascially, then, animation is easy; it is just tedious, 
because you have to keep changing various coordinates and 
then CALLing the sr routine. 
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Assembly language listing for sprite control 

We have made frequent reference to the "sprite routine" 
which uses the sprite attributes to move around the sprites. 
We Y** 1 describe this routine in some detail. Those of you 
familiar with assembly language should end up with an inti- 
mate knowledge of sprite control. But even if you don't know 
assembly language, we will try to explain things so you can 
use sprites more flexibly. 

The sprite routine consists of the numbers in the data 
statements in lines 10010 and 10020. Lines 10030-10050 POKE 
these numbers into memory starting at memory location 29600. 
This is why the variable sr equals 29600; whenever we CALL 
sr, this routine is called. We will give you an assembly 
language listing of the program with extensive comments. 

Assembly Code Decimal values from data statements 

LD C,E2H 14, 226 

LD B , 1 6,1 

CALL FD20 205,32,253 

♦•♦•comment: these lines set the magnification and size 
of the sprites. The critical value is the underlined one--in 
this case 226 will make the sprites 16x16 with no magnifica- 
tion. Changing this number to 227 will give 16x16 with 
double magnification. 224 gives 8x6 with no magnification. 
225 gives 8x8 with double magnification. 
LD A, (FC18H) 58,24,252 
LD IY,0050H 253,33, 80, 00 

♦♦♦•comment: this sets the number of entries to be used. 
In our examples, we have 20 sprites of 16x16, so we have to 
use the number 80 in the underlined value here--that is, the 
number of sprites multiplied by 4. If one were using 20 8x8 
sprites, this number would simply be 20. 
LD HL,70B2H 33, 1 78. 1 1 2 

!!II comment: load HL with tne address of the sprite 
data (28850 decimal). You will really need to understand as- 
sembly language to change this address, so you may just want 
to use it as in the sample program. 
LD DE,0000H 17,00,00 

♦♦♦♦comment: which entry should the routine start writ- 
ing to. We find it very confusing to try to change this 
value, so we always start with entry #0 and rewrite all of 
the sprites every time, rather than trying to pick out just 
a few to rewrite. The process is so fast that it makes no 
practical difference to start at entry 10 each time. We re- 
commend leaving this value alone. 
CALL FD2CH 205,44,253 

r« . !I*!^ 0mment : vrite these entries into VRAM (video RAM) 
LD A,(FC17H) 58,23,252 

♦♦♦♦comment: set up table#0--the entry point for attri- 
bute setting. 1 K 
LD IY,0014H 253,33, 20, 0 
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*** •comment : enter the number of sprites being used. 
Obviously the underlined number in this line would be 
changed to change the number of sprites. 
LD DE,0000H 17,00,00 

♦••'comment: entry to write to again 
LD HL,733CH 33,60, 115 

••••comment: location address of the sprite attributes 
data ( 29500 decimal ) 
CALL FD2CH 205,44,253 

••••comment: write attributes table to VRAM 
RET 201 



In the data statements in the framework program, the 
last number is 256, but this is not part of the sprite rou- 
tine. It is just there to signal the end of the data. 

This should give you the information you need to add 
dramatic graphics to all of your programs. 



Problems wjjj} PASK 

We need to warn you about two problems with smartBASIC. 
The first one seems to be a bug that appears with large pro- 
grams that push the limits of memory- -which your program 
probably will do. In the program, the string variable m$ is 
used to give feedback to the player. Occasionally, the 
first several letters of m$ will be skipped and random let- 
ters added on to the end. We can find no way around this, 
and just warn the player to simply try the command again. 

The second problem can be a real nuisance. For reasons 
we will never understand, each time a program is LOADed from 
tape or disk, BASIC adds a space immediately after each DATA 
statement and each REM statement. If you then make changes 
to the program and SAVE the modified version--as you often 
will when you develop a program--the extra spaces are also 
SAVEd. The next time you LOAD the program, another space 
will be added. In a program with many DATA statements, sev- 
eral SAVEs and LOADS can waste a lot of memory, and adven- 
ture games usually have little memory to spare. We find it 
necessary, every now and then, to list each DATA line and 
edit it. To do this, move the cursor under the line number, 
erase the "DATA " with the space bar, move the cursor along 
until it is five spaces from the actual data, and type in a 
new DATA command. 

Another problem is not a shortcoming of BASIC, but it 
can be the source of a hard-to-find bug. At the end of line 
160 we add one space to q$, which is the player's input. We 
put the space at the end of q$ because later the parser 
won't be able to tell the difference between "book" and 
"bookcase". In the vocabulary, book is listed with a space 
at each end: 
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book % Now it won't be confused with codebook or 
bookcase, as long as there is a space at the end of the 
player's input like "read book ". However, now we have a 
problem to watch for in line 2470, where we want to know if 
the player said "take pictures". We must say 
if q$«"take pictures " then m$»"using what 9 " 
being careful to include the space at the end of "take pic- 
tures because q$ will have a space there and BASIC is 
very fussy. When you ask if q$ equals something, it must be 
exactly 1 i ke q$ . 



BOMB SQUAD 



In this game, you have been appointed to find and de- 
fuse three bombs that have been placed in the embassy of 
tiny Lunaria, the only country with large known reserves of 
kryptonite. As with most adventure games, you will be en- 
tering two word English commands to find your way around the 
embassy, to gather whatever supplies you might need, and to 
deal with any situation a good intelligence/explosives ex- 
pert mi ght meet . 

You can move around any of the four directions, N, S, 
W, or E-- if there is a visible exit available. You can do 
this either by typing in a command like "go south" or "walk 
east" or, to save time and typing, you can simply enter one 
of the letters N, S, W, or E. These one-letter commands must 
be in upper case letters. 

The computer will describe your location and what you 
can see at each turn. You might try to accumulate objects 
for later use, but there is a limit to what you can carry. 
If you leave something in a room, it will be there waiting 
for you when you return. 

If you try to do something, and the computer tells you 
that you can't do that, try a synonym. Remember that each 
command you enter should include exactly two words--a verb 
and a noun (with the exception of the one-word direction 
commands or "save", "load", "help", or "carrying' 7 ".) 

Unlike most adventure games, Bomb Squad puts you under 
some time pressure. If you don't find the bombs fast 
enough, they will start exploding one by one. Even if this 
happens, though, remember what you learned from your experi- 
ences, so next time you will have a better chance of finding 
all three bombs. 

As a general strategy, it is essential to draw a map of 
your searches as you go. 



Sa v i nq and load i ng . 

If you are in the middle of a game and have to stop, 
you can enter the one word "SAVE" (be sure there is a tape 
or disk in place) and your current position will be SAVEd as 
a file named "bombgame". When you want to resume the game, 
LOAD the program as usual, RUN it, and then enter the one 
word command "load". This way, you don't have to start over 
from the beginning of the game. 

You may also want to SAVE the game occasionally as you 
play, so if you get killed or get into a hopeless situation, 
you won't have to start over. 



- 49 - 



50 



A bug in BASI C . 

Occasionally, you might read a sentence with part of 
the front cut off and gibberish at the end. This seems to 
be a string handling bug in BASIC. Just try your command 
again if you can't figure out what the feedback sentence 
means . 



Graphics c lues . 

Some of the scenes are presented graphically, so be 
sure you study the scene and the action in the scene to help 
you figure out the best course of action. 



Get t i ng he lp i n the game . 

If you need to Know what you are carrying, simply enter 
the word "carrying?", and the program will list your posses- 
sions. Although it is considered bad form, you can even ask 
for a list of the words that the game understands by enter- 
ing the one-word command "help". It's bad form because it 
makes the game too much easier, but if you really need to, 
far be it from us to make you feel guilty--just because you 
lack character. 



A deadly warning . 

It is possible to survive some of the explosions if you 
don't find certain bombs in time--but it is also possible 
that you might be in the same room at the very moment one 
goes off. In that unlkely event, there is nothing to be 
done but start the game again. 



r 



